Spec-Zone.ru › CakePHP 3.3

Класс 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\BreadcrumbsHelper
  • Cake\View\Helper\FlashHelper
  • Cake\View\Helper\UrlHelper
  • 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
Расположение: View/Helper.php

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

  • $_View protected
    Cake\View\View
    Экземпляр View, к которому прикреплён этот helper
  • $_defaultConfig protected
    array
    Значения конфигурации по умолчанию для этого helper.
  • $_helperMap protected
    array
    Таблица поиска helper, используемая для ленивой загрузки объектов helper.
  • $fieldset public
    array

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

  • $helpers public
    array
    Список helper, используемых этим helper
  • $plugin public
    string
    Путь к плагину
  • $request public
    Cake\Network\Request
    Объект запроса
  • $tags public
    array
    Хранит шаблоны тегов.
  • $theme public
    string
    Текущее имя темы, если таковое имеется.

Наследуемые свойства

  • _config, _configInitialized

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

  • __call() public
    Обеспечивает некритические ошибки при вызове отсутствующих методов.
  • __construct() public
    Конструктор по умолчанию
  • __debugInfo() public

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

  • __get() public
    Лениво загружает helper.
  • _confirm() protected
    Возвращает строку, которая должна использоваться в качестве обработчика onclick для диалоговых окон подтверждения.
  • addClass() public
    Добавляет заданный класс к опциям элемента
  • implementedEvents() public
    Получить View обратные вызовы, в которых заинтересован этот helper.
  • initialize() public
    Метод привязки конструктора.

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

__call()source public

__call( string $method , array $params )

Обеспечивает некритические ошибки при вызове отсутствующих методов.

Параметры

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

__construct()source public

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

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

Параметры

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

__debugInfo()source public

__debugInfo( )

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

Возвращает

массив

__get()source public

__get( string $name )

Лениво загружает helper.

Параметры

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

Возвращает

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

_confirm()source protected

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

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

Параметры

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

Возвращает

строка
код onclick JS

addClass()source public

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

Добавляет заданный класс к опциям элемента

Параметры

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

Возвращает

массив
Массив опций с установленным $key.

implementedEvents()source public

implementedEvents( )

Получить View обратные вызовы, в которых заинтересован этот helper.

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

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

Возвращает

массив

Реализация

Cake\Event\EventListenerInterface::implementedEvents()

initialize()source public

initialize( array $config )

Метод привязки конструктора.

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

Параметры

массив $config
Настройки конфигурации, предоставленные этому helper.

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

_configDelete()source protected

_configDelete( string $key )

Удалить единственный ключ конфигурации

Параметры

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

Исключения

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

_configRead()source protected

_configRead( string|null $key )

Чтение переменной конфигурации

Параметры

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

Возвращает

смешанный

_configWrite()source protected

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

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

Параметры

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

Истина для рекурсивного слияния, 'shallow' для простого слияния, ложь для перезаписи, по умолчанию ложь.

Исключения

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

config()source 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
Выполнять ли рекурсивное слияние или перезаписывать существующую конфигурацию, по умолчанию истина.

Возвращает

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

Исключения

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

configShallow()source 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
Значение для установки.

Возвращает


$this Сам объект.

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

$_Viewsource

protected Cake\View\View

Экземпляр View, к которому присоединен этот помощник

$_defaultConfigsource

protected массив

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

[]

$_helperMapsource

protected массив

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

[]

$fieldsetsource

public массив

Хранит поля ['field_name' => ['type' => 'строка', 'длина' => 100]], primaryKey и validates ['field_name']

[]

$helperssource

public массив

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

[]

$pluginsource

public строка

Путь плагина

null

$requestsource

public Cake\Network\Request

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

null

$tagssource

public массив

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

[]

$themesource

public строка

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

null

© 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/3.3/class-Cake.View.Helper.html

Spec-Zone.ru

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