Класс PrototypeEngineHelper
Помощник движка шаблонов Prototype для JsHelper
Предоставляет JavaScript-код, специфичный для Prototype, для JsHelper. Требуется как минимум Prototype 1.6
- AppHelper
-
JsBaseEngineHelper -
PrototypeEngineHelper
Авторское право: Copyright (c) Cake Software Foundation, Inc. (http://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необязательно массив() - Массив опций для draggable.
Возвращаемое значение
строкаЗавершенный скрипт draggable.
См. также
JsBaseEngineHelper::draggable() для списка опций.drop()source public
drop( array $options array() )
Создаёт элемент Droppable.
Примечание: Требуется загрузка scriptaculous.
Параметры
- массив
$optionsнеобязательно массив() - Массив опций для droppable.
Возвращаемое значение
строкаЗавершенный скрипт droppable.
См. также
JsBaseEngineHelper::droppable() для списка опций.each()source public
each( string $callback )
Создаёт итерацию по результатам текущего выбора.
Параметры
- строка
$callback - Тело функции, которое вы хотите применить во время итерации.
Возвращаемое значение
строкаЗавершенная итерация
effect()source public
effect( string $name , array $options array() )
Вызывает эффект.
Примечание: Эффекты требуют загрузки Scriptaculous.
Параметры
- строка
$name - Имя эффекта, который нужно вызвать.
- массив
$optionsнеобязательно массив() - Массив опций для эффекта.
Возвращаемое значение
строкаЗавершенная строка с эффектом.
См. также
JsBaseEngineHelper::effect()event()source public
event( string $type , string $callback , array $options array() )
Добавляет событие в кэш скрипта. Действует на текущие выбранные элементы.
Опции
-
wrap- Хотите ли вы обернуть обратный вызов в анонимную функцию. (по умолчанию true) -
stop- Хотите ли вы, чтобы событие было остановлено. (по умолчанию true)
Параметры
- строка
$type - Тип события, к которому нужно привязаться к текущему 946 id
- строка
$callback - JavaScript-функция, которую вы хотите вызвать, или литерал функции
- массив
$optionsнеобязательно массив() - Опции для события.
Возвращаемое значение
строкаЗавершенный обработчик событий
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необязательно массив() - Список опций.
Возвращаемое значение
строкаЗавершенный вызов ajax.
serializeForm()source public
serializeForm( array $options array() )
Сериализует форму, прикреплённую к $selector.
Параметры
- массив
$optionsнеобязательно массив() - Массив опций.
Возвращаемое значение
строкаЗавершенный фрагмент serializeForm()
См. также
JsBaseEngineHelper::serializeForm()slider()source public
slider( array $options array() )
Создаёт виджет управления ползунком.
Примечание: Требуется загрузка scriptaculous.
Параметры
- массив
$optionsнеобязательно массив() - Массив опций для ползунка.
Возвращаемое значение
строкаЗавершенный скрипт ползунка.
См. также
JsBaseEngineHelper::slider() для списка опций.sortable()source public
sortable( array $options array() )
Создаёт сортируемый элемент.
Примечание: Требуется загрузка scriptaculous.
Реализация sortables в scriptaculous не поддерживает опции 'start' и 'distance'.
Параметры
- массив
$optionsнеобязательно массив() - Массив опций для сортируемого элемента.
Возвращаемое значение
строкаЗавершенный скрипт сортировки.
См. также
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() )
Подготавливает обратные вызовы и оборачивает их функцией ([args]) { }, как определено в массиве _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 )
Генерирует фрагмент confirm, который возвращает false из текущего контекста функции.
Параметры
- строка
$message - Сообщение для диалогового окна подтверждения.
Возвращает
строкаРезультат confirm с возвратом скрипта
escape()source public
escape( string $string )
Экранирует строку для совместимости с JSON.
Список экранированных элементов:
- "\r" => '\n'
- "\n" => '\n'
- '"' => '\"'
Параметры
- строка
$string - Строка, которую нужно экранировать.
Возвращает
строкаЭкранированная строка.
object()source public
object( array $data array() , array $options array() )
Генерирует объект JavaScript в формате JavaScript Object Notation (JSON) из массива. Будет использовать встроенный метод 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необязательно 'значение' - Имя ключа.
Возвращает
строкаПредставление $val, безопасное для JavaScript/JSON
Подробное описание свойств
$_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–2016 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.9/class-PrototypeEngineHelper.html