Spec-Zone.ru › CakePHP 3.1

Класс Helper

Абстрактный базовый класс для всех других Helpers в CakePHP. Предоставляет общие методы и функции.

Методы обратного вызова

Helpers поддерживают ряд методов обратного вызова. Эти методы обратного вызова позволяют вам подключиться к различным событиям жизненного цикла представления и либо изменить существующее содержимое представления, либо выполнить другую специфичную для приложения логику. События не реализованы в этом базовом классе, так как реализация метода обратного вызова подписывает helper на связанное событие. Методы обратного вызова следующие:

  • beforeRender(Event $event, $viewFile) - beforeRender вызывается перед отрисовкой файла представления.
  • afterRender(Event $event, $viewFile) - afterRender вызывается после отрисовки файла представления, но перед отрисовкой макета.
  • beforeLayout(Event $event, $layoutFile)` - beforeLayout вызывается перед отрисовкой макета.
  • afterLayout(Event $event, $layoutFile) - afterLayout вызывается после отрисовки макета.
  • beforeRenderFile(Event $event, $viewFile) - Вызывается перед отрисовкой любого фрагмента представления.
  • afterRenderFile(Event $event, $viewFile, $content) - Вызывается после отрисовки любого фрагмента представления. Если слушатель возвращает ненулевое значение, вывод отрендеренного файла будет установлен на это значение.
Cake\View\Helper реализует Cake\Event\EventListenerInterface использует Cake\Core\InstanceConfigTrait

Прямые известные подклассы

Cake\View\Helper\FlashHelper, Cake\View\Helper\FormHelper, Cake\View\Helper\HtmlHelper, Cake\View\Helper\NumberHelper, Cake\View\Helper\PaginatorHelper, Cake\View\Helper\RssHelper, Cake\View\Helper\SessionHelper, Cake\View\Helper\TextHelper, Cake\View\Helper\TimeHelper, Cake\View\Helper\UrlHelper
Пространство имен: Cake\View
Расположено в View/Helper.php

Подробное описание методов

__callsource public

__call( string $method , array $params )

Предоставляет ошибки, не являющиеся фатальными, при вызовах отсутствующих методов.

Параметры

строка $method
Метод для вызова
массив $params
Массив параметров для метода.

__constructsource public

__construct( Cake\View\View $View , array $config [] )

Конструктор по умолчанию

Параметры

Cake\View\View $View
Представление, к которому подключается helper.
массив $config необязательно []
Настройки конфигурации для helper.

__debugInfosource public

__debugInfo( )

Возвращает массив, который можно использовать для описания внутреннего состояния этого объекта.

Возвращает

array
массив

__getsource public

__get( string $name )

Ленично загружает helpers.

Параметры

строка $name
Имя свойства, к которому осуществляется доступ.

Возвращает

Cake\View\Helper|null
Экземпляр helper, если helper с указанным именем существует

_confirmsource protected

_confirm( string $message , string $okCode , string $cancelCode '' , array $options [] )

Возвращает строку, используемую в качестве обработчика onclick для диалогов подтверждения.

Параметры

строка $message
Сообщение, которое должно быть отображено
строка $okCode
Код, который будет выполнен после того, как пользователь выбрал 'OK'
строка $cancelCode необязательно ''
Код, который будет выполнен после того, как пользователь выбрал 'Отмена'
массив $options необязательно []
Массив опций

Возвращает

string
JS-код onclick

addClasssource public

addClass( array $options [] , string $class null , string $key 'class' )

Добавляет указанный класс к параметрам элемента

Параметры

массив $options необязательно []
Массив опций/атрибутов, к которым нужно добавить класс
строка $class необязательно null
Имя добавляемого класса.
строка $key необязательно 'class'
ключ для использования класса.

Возвращает

array
Массив опций со значением $key.

implementedEventssource public

implementedEvents( )

Получить методы обратного вызова представления, которые интересуют этот helper.

Определяя один из методов обратного вызова, предполагается, что helper интересуется соответствующим событием.

Переопределите этот метод, если вам нужно добавить нестандартные слушатели событий. Или если вы хотите, чтобы helpers прослушивали нестандартные события.

Возвращает

array
массив

Реализация

Cake\Event\EventListenerInterface::implementedEvents()

Методы, используемые из Cake\Core\InstanceConfigTrait

_configDeletesource protected

_configDelete( string $key )

Удалить ключ конфигурации

Параметры

строка $key
Ключ для удаления.

Выбрасывает

Cake\Core\Exception\Exception
если пытаетесь перезаписать существующую конфигурацию

_configReadsource protected

_configRead( string|null $key )

Прочитать переменную конфигурации

Параметры

строка|null $key
Ключ для чтения.

Возвращает

mixed
смешанный тип

_configWritesource protected

_configWrite( string|array $key , mixed $value , boolean|string $merge false )

Записать переменную конфигурации

Параметры

строка|массив $key
Ключ для записи.
смешанный тип $value
Значение для записи.
булево|строка $merge необязательно false
Истина для рекурсивного слияния, 'shallow' для простого слияния, ложь для перезаписи, по умолчанию ложь.

Выбрасывает

Cake\Core\Exception\Exception
если пытаетесь перезаписать существующую конфигурацию

configsource public

config( string|array|null $key null , mixed|null $value null , boolean $merge true )

Использование

Чтение всей конфигурации:

$this->config();

Чтение определённого значения:

$this->config('key');

Чтение вложенного значения:

$this->config('some.nested.key');

Установка определённого значения:

$this->config('key', $value);

Установка вложенного значения:

$this->config('some.nested.key', $value);

Обновление нескольких параметров конфигурации одновременно:

$this->config(['one' => 'value', 'another' => 'value']);

Параметры

строка|массив|null $key необязательно null
Ключ для получения/установки или весь массив конфигураций.
смешанный тип|null $value необязательно null
Значение для установки.
булево $merge необязательно true
Выполнять ли рекурсивное слияние или перезаписывать существующую конфигурацию, по умолчанию истинно.

Возвращает

mixed
Значение конфигурации, которое считывается, или сам объект при операциях записи.

Выбрасывает

Cake\Core\Exception\Exception
При попытке установить неверный ключ.

configShallowsource public

configShallow( string|array $key , mixed|null $value null )

Объединить предоставленную конфигурацию с существующей конфигурацией. В отличие от config(), которая выполняет рекурсивное слияние для вложенных ключей, этот метод выполняет простое слияние.

Установка определённого значения:

$this->config('key', $value);

Установка вложенного значения:

$this->config('some.nested.key', $value);

Обновление нескольких параметров конфигурации одновременно:

$this->config(['one' => 'value', 'another' => 'value']);

Параметры

строка|массив $key
Ключ для установки, или весь массив конфигураций.
смешанный тип|null $value необязательно null
Значение для установки.

Возвращает

mixed
Сам объект.

Краткое описание свойств

$_Viewsource

protected Cake\View\View

Экземпляр объекта View, к которому прикреплён этот помощник

$_defaultConfigsource

protected array

Конфигурация по умолчанию для этого помощника.

[]

$_helperMapsource

protected array

Таблица поиска помощников, используемая для ленивой загрузки объектов помощников.

[]

$fieldsetsource

public array

Содержит поля ['имя_поля' => ['тип' => 'строка', 'длина' => 100]], первичный ключ и валидацию ['имя_поля']

[]

$helperssource

public array

Список помощников, используемых этим помощником

[]

$pluginsource

public string

Путь к плагину

null

$requestsource

public Cake\Network\Request

Объект запроса

null

$tagssource

public array

Содержит шаблоны тегов.

[]

$themesource

public string

Имя текущей темы, если есть.

null

Свойства, используемые из Cake\Core\InstanceConfigTrait

$_configsource

protected array

Конфигурация выполнения

[]

$_configInitializedsource

protected boolean

Указатель, был ли конфигурация свойства уже настроено с значениями по умолчанию

false

© 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.
http://api.cakephp.org/3.1/class-Cake.View.Helper.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API