Класс JsHelper
Класс-помощник Javascript Generator для простого использования JavaScript.
JsHelper предоставляет абстрактный интерфейс для создания JavaScript с использованием заданной клиентской библиотеки.
- AppHelper
-
JsHelper
Авторские права: Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/View/Helper/JsHelper.php
Краткое описание свойств
-
$_bufferedScriptsprotectedСкрипты, которые находятся в очереди для выводаarray -
$_engineNameprotectedТекущий движок JavaScript, который используетсяstring -
$_jsVarsprotectedПеременные для передачи в Javascript.array -
$bufferScriptspublicБуферизовать или выводить скрипты.boolean -
$helperspublicЗависимости помощникаarray -
$setVariablepublicПеременная javascript, созданная переменными set().string
Краткое описание магических свойств
Краткое описание методов
- __call() public
Разрешает вызов методов помощника двигателя. Методы в списке bufferedMethods двигателя будут автоматически буферизованы. Вы можете управлять буферизацией с помощью параметра буфера также. Установив последний параметр любого метода двигателя в булево значение, вы можете принудительно включить или отключить буферизацию.
- __construct() publicКонструктор - определяет помощника движка
- _createVars() protectedГенерирует строку объекта для переменных, передаваемых в javascript, и добавляет ее в буфер
- _getHtmlOptions() protected
Обработка набора параметров и извлечение параметров Html. Извлеченные параметры Html удаляются из параметра $options.
- buffer() publicЗаписать скрипт в буферизованные скрипты.
- getBuffer() publicПолучить все буферизованные скрипты
- link() public
Генерирует ссылку 'Ajax'. Использует выбранный движок JS для создания элемента ссылки, который расширен JavaScript. Параметры могут включать как те, что для HtmlHelper::link(), так и для JsBaseEngine::request(), JsBaseEngine::event();
- set() public
Передать переменные в Javascript. Позволяет устанавливать переменные, которые будут выведены при получении буфера с помощью
JsHelper::getBuffer()илиJsHelper::writeBuffer(). Переменную Javascript, используемую для вывода переменных set, можно контролировать с помощьюJsHelper::$setVariable - submit() public
Использует выбранный движок JS для создания элемента ввода submit, который расширен JavaScript. Параметры могут включать как те, что для FormHelper::submit(), так и для JsBaseEngine::request(), JsBaseEngine::event();
- value() public
Переопределяет унаследованный Helper::value(). См. JsBaseEngineHelper::value() для получения дополнительной информации об этом методе.
- writeBuffer() public
Записывает весь сгенерированный Javascript в блок кода или кеширует их в файл и возвращает связанный скрипт. Если скрипты не были буферизованы, этот метод вернет null. Если запрос является XHR (ajax)-запросом, onDomReady будет установлен в false. Так как DOM уже "готов".
Подробное описание методов
__call()source public
__call( string $method , array $params )
Разрешает вызов методов помощника двигателя. Методы в списке bufferedMethods двигателя будут автоматически буферизованы. Вы можете управлять буферизацией с помощью параметра буфера также. Установив последний параметр любого метода двигателя в булево значение, вы можете принудительно включить или отключить буферизацию.
Например: $js->get('#foo')->effect('fadeIn', array('speed' => 'slow'), true);
Принудительно включит буферизацию для метода effect. Если метод принимает массив параметров, вы также можете добавить параметр 'buffer' в массив параметров и управлять буферизацией там также.
Например: $js->get('#foo')->event('click', $functionContents, array('buffer' => true));
Параметр buffer не будет передан в EngineHelper.
Параметры
- строка
$method - Метод, который будет вызван
- массив
$params - Параметры для вызываемого метода.
Возвращает
смешанноеЗависит от результата вызова метода или это может быть экземпляр EngineHelper
__construct()source public
__construct( View $View , string|array $settings array() )
Конструктор - определяет помощника движка
Параметры
-
View$View - объект представления, к которому прикреплен помощник.
- строка|массив
$settingsнеобязательно массив() - Массив настроек содержит имя помощника движка.
_createVars()source protected
_createVars( )
Генерирует строку объекта для переменных, передаваемых в javascript, и добавляет ее в буфер
_getHtmlOptions()source protected
_getHtmlOptions( array $options , array $additional array() )
Обработка набора параметров и извлечение параметров Html. Извлеченные параметры Html удаляются из параметра $options.
Параметры
- массив
$options - Параметры для фильтрации.
- массив
$additionalнеобязательно массив() - Массив дополнительных ключей для извлечения и включения в возвращаемый массив параметров.
Возвращает
массивМассив параметров js и Htmloptions
buffer()source public
buffer( string $script , boolean $top false )
Записать скрипт в буферизованные скрипты.
Параметры
- строка
$script - Строка скрипта для добавления в буфер.
- булево
$topнеобязательно false Если true, скрипт будет добавлен в начало массива буферизованных скриптов. Если false — в конец.
Ссылка
https://book.cakephp.org/2.0/en/core-libraries/helpers/js.html#JsHelper::buffergetBuffer()source public
getBuffer( boolean $clear true )
Получить все буферизованные скрипты
Параметры
- булево
$clearнеобязательно true - Очистить ли кэш скриптов (по умолчанию true)
Возвращает
массивМассив скриптов, добавленных к запросу.
Ссылка
https://book.cakephp.org/2.0/en/core-libraries/helpers/js.html#JsHelper::getBufferlink()source public
link( string $title , string|array $url null , array $options array() )
Создать ссылку 'Ajax'. Использует выбранный JS-движок для создания элемента ссылки, который улучшен с помощью Javascript. Параметры могут включать как те, что для HtmlHelper::link(), так и для JsBaseEngine::request(), JsBaseEngine::event();
Параметры
-
confirm- Сгенерировать диалоговое окно подтверждения confirm() перед отправкой события. -
id- использовать пользовательский идентификатор. -
htmlAttributes- дополнительные нестандартные htmlAttributes. Стандартные атрибуты — class, id, rel, title, escape, onblur и onfocus. -
buffer- Отключить буферизацию и вернуть тег скрипта дополнительно к ссылке.
Параметры
- строка
$title - Текст ссылки.
- строка|массив
$urlнеобязательно null - Смешанный тип: либо строка URL, либо массив CakePHP URL.
- массив
$optionsнеобязательно массив() - Параметры как для HTML-элемента, так и для Js::request()
Возвращаемое значение
строкаЗавершенная ссылка. Если буферизация отключена, возвращается также тег скрипта.
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/js.html#JsHelper::linkset()source public
set( string|array $one , string|array $two null )
Передать переменные в Javascript. Позволяет задать переменные, которые будут выведены при получении буфера с помощью JsHelper::getBuffer() или JsHelper::writeBuffer() Переменная Javascript, используемая для вывода заданных переменных, может контролироваться с помощью JsHelper::$setVariable
Параметры
- строка|массив
$one - Массив переменных для установки или имя переменной для установки.
- строка|массив
$twoнеобязательно null - Если $one — строка, то $two — значение для этого ключа.
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/js.html#JsHelper::setsubmit()source public
submit( string $caption null , array $options array() )
Использует выбранный JS-движок для создания элемента ввода submit, который улучшен с помощью Javascript. Параметры могут включать как те, что для FormHelper::submit(), так и для JsBaseEngine::request(), JsBaseEngine::event();
Формы, отправляемые этим методом, не могут отправлять файлы. Файлы не передаются по XmlHttpRequest и требуют iframe или flash.
Параметры
-
urlАдрес, куда вы хотите отправить запрос XHR. -
confirmСтрока для сообщения confirm() перед отправкой запроса. -
methodМетод отправки формы, по умолчанию POST -
bufferНеобходимо ли буферизовать код скрипта, по умолчанию true. - Также см. параметры для JsHelper::request() и JsHelper::event()
Параметры
- строка
$captionнеобязательно null - Текст отображения кнопки отправки.
- массив
$optionsнеобязательно массив() - Массив параметров. См. параметры вышеупомянутых методов.
Возвращаемое значение
строкаЗавершенная кнопка отправки.
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/js.html#JsHelper::submitvalue()source public
value( mixed $val array() , boolean $quoteString null , string $key 'value' )
Переопределение унаследованного Helper::value() Дополнительная информация об этом методе содержится в JsBaseEngineHelper::value().
Параметры
- смешанный
$valнеобязательно массив() - PHP переменная для преобразования в JSON
- булево
$quoteStringнеобязательно null - Если false, значения строк не заключаются в кавычки
- строка
$keyнеобязательно 'значение' - Имя ключа.
Возвращаемое значение
строкаПредставление $val, безопасное для JavaScript/JSON
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/js.html#JsHelper::valuewriteBuffer()source public
writeBuffer( array $options array() )
Записывает весь сгенерированный Javascript в блок кода или кеширует его в файл и возвращает ссылку на скрипт. Если не было закешированных скриптов, этот метод вернёт null. Если запрос — XHR (ajax), onDomReady будет установлен в false. Так как DOM уже «готов».
Параметры
-
inline- Установить в true, чтобы скрипты выводились как inline-блок скрипта. Еслиcacheтакже true, будет сгенерирован тег ссылки на скрипт. (по умолчанию true) -
cache- Установить в true, чтобы скрипты кешировались в файле и ссылались на них (по умолчанию false) -
clear- Установить в false, чтобы предотвратить очистку кэша скриптов (по умолчанию true) -
onDomReady- Установить в true, чтобы обернуть кешированные скрипты в событие domready (по умолчанию true) -
safe- Если генерируется inline-блок, следует ли его обернуть в (по умолчанию true)
Параметры
- массив
$optionsнеобязательно массив() - Параметры для блока кода
Возвращаемое значение
смешанныйЗавершенный тег javascript, если есть скрипты; если нет закешированных скриптов, будет возвращен null.
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/helpers/js.html#JsHelper::writeBufferПодробное описание свойств
$_bufferedScriptssource
protected массив
Скрипты, которые ожидаются для вывода
См. также
JsHelper::buffer()array()
$_jsVarssource
protected массив
Переменные для передачи в Javascript.
См. также
JsHelper::set()array()
$setVariablesource
public строка
Переменная Javascript, созданная методом set() для переменных.
'app'
Подробное описание магических свойств
$Formsource
public FormHelper
$Htmlsource
public HtmlHelper
© 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-JsHelper.html