Spec-Zone.ru › CakePHP 3.3

Класс FlashHelper

Класс FlashHelper для отображения сообщений всплывающих сообщений.

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

Cake\View\Helper implements Cake\Event\EventListenerInterface uses Cake\Core\InstanceConfigTrait
Расширенный Cake\View\Helper\FlashHelper
Пространство имён: Cake\View\Helper
Расположение: View/Helper/FlashHelper.php

Унаследованные свойства

  • _View, _defaultConfig, _helperMap, fieldset, helpers, plugin, request, tags, theme _config, _configInitialized

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

  • implementedEvents() public
    Обработчики событий.
  • render() public
    Используется для отображения сообщения, установленного в FlashComponent::set()

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

implementedEvents()source public

implementedEvents( )

Обработчики событий.

Возвращает

array

Переопределяет

Cake\View\Helper::implementedEvents()

render()source public

render( string $key 'flash' , array $options [] )

Используется для отображения сообщения, установленного в FlashComponent::set()

В вашем представлении: $this->Flash->render('somekey'); По умолчанию используется flash, если параметр не передан

Вы можете передать дополнительную информацию в создание сообщения всплывающего сообщения. Это позволяет вам объединить все параметры для данного типа всплывающего сообщения в представлении.

echo $this->Flash->render('flash', ['params' => ['name' => $user['User']['name']]]);

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

Наконец, вы можете выбрать элемент, который используется для отображения всплывающего сообщения. Использование пользовательских элементов позволяет полностью настроить способ генерации всплывающих сообщений.

echo $this->Flash->render('flash', ['element' => 'my_custom_element']);

Если вы хотите использовать элемент из плагина для отображения всплывающего сообщения, вы можете использовать обозначение точек для имени элемента плагина:

echo $this->Flash->render('flash', [
  'element' => 'MyPlugin.my_custom_element',
]);

Если в сессии хранится несколько сообщений, каждое сообщение будет отображено в своем собственном элементе.

Параметры

строка $key необязательно 'flash'
Ключ [Flash.] для отображения в представлении.
массив $options необязательно []

Дополнительные параметры для использования при создании этого всплывающего сообщения. Поддерживает ключи 'params' и 'element', используемые в помощнике.

Возвращает

строка|null

Отображаемое всплывающее сообщение или null, если ключ всплывающего сообщения отсутствует в сессии.


Исключения

UnexpectedValueException
Если значение для ключа настроек всплывающего сообщения не является массивом.

Методы, унаследованные от Cake\View\Helper

__call()source public

__call( string $method , array $params )

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

Параметры

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

__construct()source public

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

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

Параметры

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

__debugInfo()source public

__debugInfo( )

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

Возвращает

массив

__get()source public

__get( string $name )

Ленизагрузка помощников.

Параметры

строка $name
Имя свойства, к которому производится доступ.

Возвращает

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

_confirm()source protected

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

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

Параметры

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

Возвращает

строка
JS код onclick

addClass()source public

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

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

Параметры

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

Возвращает

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

initialize()source public

initialize( array $config )

Метод-обработчик конструктора.

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

Параметры

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

Методы, используемые из 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

True для рекурсивного объединения, 'shallow' для простого объединения, false для перезаписи, по умолчанию false.

Исключения

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

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']);

Параметры

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

Возвращает

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

Исключения

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']);

Параметры

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

Возвращает


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

© 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.FlashHelper.html

Spec-Zone.ru

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