Класс FlashHelper
Класс FlashHelper для отображения всплывающих сообщений.
После установки сообщений в ваших контроллерах с помощью FlashComponent, вы можете использовать этот класс для вывода всплывающих сообщений в ваших представлениях.
- Cake\View\Helper implements Cake\Event\EventListenerInterface uses Cake\Core\InstanceConfigTrait
-
Cake\View\Helper\FlashHelper
Унаследованные свойства
Краткое описание методов
- 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, если ключ flash не существует в сессии.
Исключения
UnexpectedValueExceptionЕсли значение для ключа настроек flash не является массивом.
Методы, унаследованные от 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Экземпляр помощника, если помощник с указанным именем существует
__set()source public
__set( string $name , mixed $value )
Магический установщик для удаленных свойств.
Параметры
- строка
$name - Имя свойства.
- смешанный
$value - Значение для установки.
_cleanConfirmMessage()source protected
_cleanConfirmMessage( string $message )
Возвращает строку, готовую для использования в confirm()
Параметры
- строка
$message - Сообщение для очистки
Возвращает
смешанный_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.
getView()source public
getView( )
Получить экземпляр представления, к которому привязан помощник.
Возвращает
Cake\View\ViewЭкземпляр привязанного представления.
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 )
Записывает значение конфигурации.
Параметры
- string|array
$key - Ключ для записи.
- mixed
$value - Значение для записи.
- boolean|string
$mergeнеобязательно false True для рекурсивного слияния, 'shallow' для простого слияния, false для перезаписи, по умолчанию false.
Исключения
Cake\Core\Exception\Exceptionпри попытке перезаписать существующую конфигурацию
config()source public deprecated
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']);
Устарело
3.4.0 используйте setConfig()/getConfig() вместо.Параметры
- 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->configShallow('key', $value); Установка вложенного значения:
$this->configShallow('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Параметры
- string|array
$key - Ключ для установки, или полный массив конфигураций.
- mixed|null
$valueнеобязательно null - Значение для установки.
Возвращает
$this
getConfig()source public
getConfig( string|null $key = null , mixed $default = null )
Возвращает конфигурацию.
Использование
Чтение всей конфигурации:
$this->getConfig();
Чтение определенного значения:
$this->getConfig('key'); Чтение вложенного значения:
$this->getConfig('some.nested.key'); Чтение со значением по умолчанию:
$this->getConfig('some-key', 'default-value'); Параметры
- string|null
$keyнеобязательно null - Ключ для получения или null для всей конфигурации.
- mixed
$defaultнеобязательно null - Значение по умолчанию, если ключ не существует.
Возвращает
mixedДанные конфигурации по указанному ключу или null, если ключ не существует.
setConfig()source public
setConfig( string|array $key , mixed|null $value = null , boolean $merge = true )
Устанавливает конфигурацию.
Использование
Установка определенного значения:
$this->setConfig('key', $value); Установка вложенного значения:
$this->setConfig('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->setConfig(['one' => 'value', 'another' => 'value']);
Параметры
- string|array
$key - Ключ для установки, или полный массив конфигураций.
- mixed|null
$valueнеобязательно null - Значение для установки.
- boolean
$mergeнеобязательно true - Выполнять рекурсивное слияние или перезапись существующей конфигурации, по умолчанию true.
Возвращает
$this
Исключения
Cake\Core\Exception\ExceptionПри попытке установить недействительный ключ.
© 2005–present 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.8/class-Cake.View.Helper.FlashHelper.html