Класс PrototypeEngineHelper
Справочник по движку Prototype для JsHelper
Предоставляет JavaScript-код, специфичный для Prototype, для JsHelper. Требуется поддержка Prototype 1.6 или более поздней версии.
- AppHelper
-
JsBaseEngineHelper
-
PrototypeEngineHelper
Авторские права: Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/View/Helper/PrototypeEngineHelper.php
Краткое описание свойств
-
$_callbackArgumentsprotectedСодержит список имен обратных вызовов и их аргументов по умолчанию.array -
$_multipleprotectedПредставляет ли текущий выбор множественный выбор или выбор одного элемента.boolean -
$_optionMapprotectedСопоставление опций для Prototypearray
Унаследованные свойства
Краткое описание методов
- domReady() publicСоздаёт событие domReady. Это специальное событие во многих библиотеках
- drag() publicСоздаёт элемент Draggable.
- drop() publicСоздаёт элемент Droppable.
- each() publicСоздаёт итерацию по результатам текущего выбора.
- effect() publicВызывает эффект.
- event() publicДобавляет событие в кэш скрипта. Осуществляет действия над текущими выбранными элементами.
- get() publicСоздаёт селектор JavaScript для CSS-правила
- request() publicСоздаёт вызов Ajax или Ajax.Updater.
- serializeForm() publicСериализует форму, привязанную к $selector.
- slider() publicСоздаёт элемент управления слайдером.
- sortable() publicСоздаёт сортируемый элемент.
Подробное описание методов
domReady()source public
domReady( string $functionBody )
Создаёт событие domReady. Это специальное событие во многих библиотеках
Параметры
- строка
$functionBody - Код, который будет выполняться при domReady
Возвращаемое значение
строкаготовый метод domReady
drag()source public
drag( array $options array() )
Создаёт элемент Draggable.
Примечание: Требуется загрузка scriptaculous.
Параметры
- массив
$optionsнеобязательно array() - Массив параметров для draggable.
Возвращаемое значение
строкаЗавершенный код draggable.
См. также
JsBaseEngineHelper::draggable() для списка параметров.drop()source public
drop( array $options array() )
Создаёт элемент Droppable.
Примечание: Требуется загрузка scriptaculous.
Параметры
- массив
$optionsнеобязательно array() - Массив параметров для droppable.
Возвращаемое значение
строкаЗавершенный код droppable.
См. также
JsBaseEngineHelper::droppable() для списка параметров.each()source public
each( string $callback )
Создаёт итерацию по результатам текущего выбора.
Параметры
- строка
$callback - Тело функции, которое необходимо применить во время итерации.
Возвращаемое значение
строказавершенная итерация
effect()source public
effect( string $name , array $options array() )
Вызывает эффект.
Примечание: Для эффектов требуется загрузка Scriptaculous.
Параметры
- строка
$name - Имя эффекта, который необходимо вызвать.
- массив
$optionsнеобязательно array() - Массив параметров для эффекта.
Возвращаемое значение
строказавершенная строка с эффектом.
См. также
JsBaseEngineHelper::effect()event()source public
event( string $type , string $callback , array $options array() )
Добавляет событие в кэш скрипта. Действует на текущие выбранные элементы.
Опции
-
wrap- Хотите ли вы обернуть обратный вызов в анонимную функцию. (по умолчанию true) -
stop- Хотите ли вы, чтобы событие было остановлено. (по умолчанию true)
Параметры
- строка
$type - Тип события, которое нужно привязать к текущему элементу
- строка
$callback - Функция JavaScript, которую вы хотите вызвать, или функция-литерал
- массив
$optionsнеобязательно array() - Параметры для события.
Возвращаемое значение
строказавершенный обработчик событий
get()source public
get( string $selector )
Создаёт селектор JavaScript для CSS-правила
Параметры
- строка
$selector - Целевой селектор
Возвращаемое значение
PrototypeEngineHelperrequest()source public
request( string|array $url , array $options array() )
Создаёт вызов Ajax или Ajax.Updater.
Параметры
- строка|массив
$url - URL.
- массив
$optionsнеобязательно array() - Список параметров.
Возвращаемое значение
строкаЗавершенный вызов ajax.
serializeForm()source public
serializeForm( array $options array() )
Сериализует форму, привязанную к $selector.
Параметры
- массив
$optionsнеобязательно array() - Массив параметров.
Возвращаемое значение
строкаЗавершенный фрагмент serializeForm()
См. также
JsBaseEngineHelper::serializeForm()slider()source public
slider( array $options array() )
Создаёт элемент управления слайдером.
Примечание: Требуется загрузка scriptaculous.
Параметры
- массив
$optionsнеобязательно array() - Массив параметров для слайдера.
Возвращаемое значение
строкаЗавершенный код слайдера.
См. также
JsBaseEngineHelper::slider() для списка параметров.sortable()source public
sortable( array $options array() )
Создаёт сортируемый элемент.
Примечание: Требуется загрузка scriptaculous.
Реализация сортировки в scriptaculous не поддерживает параметры 'start' и 'distance'.
Параметры
- массив
$optionsнеобязательно array() - Массив параметров для сортировки.
Возвращаемое значение
строкаЗавершенный код сортировки.
См. также
JsBaseEngineHelper::sortable() для списка параметров.Унаследованные методы из JsBaseEngineHelper
_mapOptions()source protected
_mapOptions( string $method , array $options )
Преобразует параметры Abstract в имена параметров конкретного движка. Если атрибуты отсутствуют в отображении, они не изменяются.
Параметры
- строка
$method - Имя метода, параметры которого обрабатываются.
- массив
$options - Массив параметров для преобразования.
Возвращает
массивМассив преобразованных параметров.
_parseOptions()source protected
_parseOptions( array $options , array $safeKeys array() )
Разбирает ассоциативный массив параметров в строку-литерал объекта JavaScript. Аналогично object(), но обрабатывает все значения, отличные от целых чисел, как строки, и не включает { }
Параметры
- массив
$options - Параметры для преобразования
- массив
$safeKeysнеобязательно массив() - Ключи, которые не должны быть экранированы.
Возвращает
строкаОбработанные JSON параметры без окружающих { }.
_prepareCallbacks()source protected
_prepareCallbacks( string $method , array $options , array $callbacks array() )
Подготавливает обратные вызовы и оборачивает их функцией ([аргументы]) { }, как определено в массиве _callbackArgs.
Параметры
- строка
$method - Имя метода, для которого подготавливаются обратные вызовы.
- массив
$options - Массив обрабатываемых параметров.
- массив
$callbacksнеобязательно массив() - Дополнительные ключи, содержащие обратные вызовы.
Возвращает
массивМассив параметров с добавленными обратными вызовами.
_processOptions()source protected
_processOptions( string $method , array $options )
Удобный оберточный метод для всех общих шагов обработки параметров. Выполняет _mapOptions, _prepareCallbacks и _parseOptions в указанном порядке.
Параметры
- строка
$method - Имя метода, для которого обрабатываются параметры.
- массив
$options - Массив параметров для обработки.
Возвращает
строкаОбработанная строка параметров.
_toQuerystring()source protected
_toQuerystring( array $parameters )
Преобразует массив данных в строку запроса.
Параметры
- массив
$parameters - Массив параметров для преобразования в строку запроса.
Возвращает
строкаЧасть строки запроса.
_utf8ToHex()source protected
_utf8ToHex( string $string )
Кодирует строку в JSON. Преобразует и экранирует необходимые символы.
Параметры
- строка
$string - Строка, которая должна быть закодирована utf8->hex.
alert()source public
alert( string $message )
Создаёт сообщение alert() в JavaScript
Параметры
- строка
$message - Сообщение, которое нужно изменить.
Возвращает
строкаЗавершенная функция alert()
confirm()source public
confirm( string $message )
Создаёт сообщение confirm()
Параметры
- строка
$message - Сообщение, которое нужно подтвердить.
Возвращает
строкаЗавершенная функция confirm()
confirmReturn()source public
confirmReturn( string $message )
Генерирует фрагмент подтверждения, который возвращает false из текущей области видимости функции.
Параметры
- строка
$message - Сообщение для использования в диалоговом окне подтверждения.
Возвращает
строкаЗавершенное подтверждение с возвращаемым скриптом
escape()source public
escape( string $string )
Экранирует строку для совместимости с JSON.
Список экранируемых элементов:
- "\r" => '\n'
- "\n" => '\n'
- '"' => '\"'
Параметры
- строка
$string - Строка, которую нужно экранировать.
Возвращает
строкаЭкранированная строка.
object()source public
object( array $data array() , array $options array() )
Генерирует объект JavaScript в формате JSON из массива. Будет использовать метод native JSON encode, если он доступен, и $useNative == true.
Параметры:
-
prefix- Строка, добавляемая перед возвращаемыми данными. -
postfix- Строка, добавляемая после возвращаемых данных.
Параметры
- массив
$dataнеобязательно массив() - Данные для преобразования.
- массив
$optionsнеобязательно массив() - Набор параметров, см. выше.
Возвращает
строкаБлок кода JSON
prompt()source public
prompt( string $message , string $default '' )
Создаёт функцию prompt() JavaScript
Параметры
- строка
$message - Сообщение для запроса.
- строка
$defaultнеобязательно '' - Значение по умолчанию
Возвращает
строкаЗавершенная функция prompt()
redirect()source public
redirect( string|array $url null )
Перенаправляет на URL. Создаёт фрагмент модификации window.location, который можно использовать для перенаправлений из JavaScript.
Параметры
- строка|массив
$urlнеобязательно null - URL
Возвращает
строкаЗавершенное перенаправление в JavaScript
value()source public
value( mixed $val array() , boolean $quoteString null , string $key 'value' )
Преобразует переменную PHP любого типа в JSON-эквивалентное представление.
Параметры
- смешанный
$valнеобязательно массив() - Переменная PHP для преобразования в JSON.
- логическое
$quoteStringнеобязательно null - Если false, оставляет строковые значения без кавычек.
- строка
$keyнеобязательно 'value' - Имя ключа.
Возвращает
строкаJavaScript-безопасное/JSON представление $val
Подробности свойств
$_callbackArgumentssource
protected массив
Содержит список имён обратных вызовов -> аргументов по умолчанию.
array(
'slider' => array(
'onSlide' => 'value',
'onChange' => 'value',
),
'drag' => array(
'onStart' => 'event',
'onDrag' => 'event',
'change' => 'draggable',
'onEnd' => 'event',
),
'drop' => array(
'onHover' => 'draggable, droppable, event',
'onDrop' => 'draggable, droppable, event',
),
'request' => array(
'onCreate' => 'transport',
'onComplete' => 'transport',
'onFailure' => 'response, jsonHeader',
'onRequest' => 'transport',
'onSuccess' => 'response, jsonHeader'
),
'sortable' => array(
'onStart' => 'element',
'onChange' => 'element',
'onUpdate' => 'element',
),
) $_optionMapsource
protected массив
Карта соответствия параметров для Prototype
array(
'request' => array(
'async' => 'asynchronous',
'data' => 'parameters',
'before' => 'onCreate',
'success' => 'onSuccess',
'complete' => 'onComplete',
'error' => 'onFailure'
),
'sortable' => array(
'sort' => 'onChange',
'complete' => 'onUpdate',
),
'drag' => array(
'snapGrid' => 'snap',
'container' => 'constraint',
'stop' => 'onEnd',
'start' => 'onStart',
'drag' => 'onDrag',
),
'drop' => array(
'hover' => 'onHover',
'drop' => 'onDrop',
'hoverClass' => 'hoverclass',
),
'slider' => array(
'direction' => 'axis',
'change' => 'onSlide',
'complete' => 'onChange',
'value' => 'sliderValue',
)
)
© 2005–2017 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/2.10/class-PrototypeEngineHelper.html