Класс FlashHelper
Класс FlashHelper для отображения сообщений всплывающих сообщений.
После установки сообщений в контроллерах с помощью FlashComponent, вы можете использовать этот класс для вывода сообщений всплывающих сообщений в ваших представлениях.
- Cake\View\Helper implements Cake\Event\EventListenerInterface uses Cake\Core\InstanceConfigTrait
-
Cake\View\Helper\FlashHelper
Унаследованные свойства
-
_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при попытке перезаписи существующей конфигурации
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