Класс ViewBlock
ViewBlock реализует концепцию блоков или слотов в слое представления. Слоты или блоки комбинируются с расширяемыми представлениями и макетами, чтобы обеспечить слоты содержимого, которые присутствуют в макете или родительском представлении, но определяются дочерним представлением или элементами, используемыми в представлении.
Краткое описание констант
-
stringAPPEND'append' -
stringOVERRIDE'override' -
stringPREPEND'prepend'
Краткое описание свойств
-
$_activeprotectedАктивные блоки, которые захватываются.array -
$_blocksprotectedСодержимое блока. Массив блоков, индексированных по имени.array -
$_discardActiveBufferOnEndprotectedСледует ли отбрасывать захваченное содержимое при вызове ViewBlock::end()boolean
Краткое описание методов
- active() publicПолучение имени текущего открытого блока.
- concat() public
Добавление содержимого к существующему или новому блоку. Добавление к новому блоку создаст этот блок.
- end() publicЗавершение захвата блока. Соответствие ViewBlock::start()
- exists() publicПроверка существования блока
- get() publicПолучение содержимого блока.
- keys() publicПолучение имён всех существующих блоков.
- set() public
Установка содержимого блока. Это перезапишет любое существующее содержимое.
- start() publicНачать захват вывода для 'блока'
- unclosed() publicПолучение имён незакрытых/активных блоков.
Подробное описание методов
active()source public
active( )
Получение имени текущего открытого блока.
Возвращаемое значение
string|nullЛибо null, либо имя последнего открытого блока.
concat()source public
concat( string $name , mixed $value = null , string $mode = ViewBlock::APPEND )
Добавление содержимого к существующему или новому блоку. Добавление к новому блоку создаст этот блок.
Вызов concat() без значения создаст новый захватывающий блок, который необходимо завершить с помощью View::end(). Содержимое новой захватывающей области будет добавлено к существующей области контекста блока.
Параметры
- string
$name - Имя блока
- mixed
$valueнеобязательно null Содержимое блока. Значение будет приведено к типу string.
- string
$modeнеобязательно ViewBlock::APPEND Если ViewBlock::APPEND, содержимое будет добавлен к существующему. Если ViewBlock::PREPEND, оно будет помещено в начало.
end()source public
end( )
Завершение захвата блока. Соответствие ViewBlock::start()
См. также
\Cake\View\ViewBlock::start()exists()source public
exists( string $name )
Проверка существования блока
Параметры
- string
$name - Имя блока
Возвращаемое значение
booleanget()source public
get( string $name , string $default = '' )
Получение содержимого блока.
Параметры
- string
$name - Имя блока
- string
$defaultнеобязательно '' - Строка по умолчанию
Возвращаемое значение
stringСодержимое блока или $default, если блок не существует.
keys()source public
keys( )
Получение имён всех существующих блоков.
Возвращаемое значение
string[]Массив, содержащий блоки.
set()source public
set( string $name , mixed $value )
Установка содержимого блока. Это перезапишет любое существующее содержимое.
Параметры
- string
$name - Имя блока
- mixed
$value Содержимое блока. Значение будет приведено к типу string.
start()source public
start( string $name , string $mode = ViewBlock::OVERRIDE )
Начать захват вывода для 'блока'
Блоки позволяют создавать слоты или блоки динамического содержимого в макете. Файлы представления могут реализовывать некоторые или все слоты макета.
Вы можете завершать захватывающие блоки с помощью View::end(). Блоки можно выводить с помощью View::get();
Параметры
- string
$name - Имя блока для захвата.
- string
$modeнеобязательно ViewBlock::OVERRIDE Если ViewBlock::OVERRIDE, существующее содержимое будет перезаписано новым. Если ViewBlock::APPEND, содержимое будет добавлен к существующему. Если ViewBlock::PREPEND, оно будет помещено в начало.
Исключения
Cake\Core\Exception\ExceptionПри повторном запуске блока
unclosed()source public
unclosed( )
Получение имён незакрытых/активных блоков.
Возвращаемое значение
arrayМассив незакрытых блоков.
Подробное описание свойств
$_discardActiveBufferOnEndsource
protected boolean
Следует ли отбрасывать захваченное содержимое при вызове ViewBlock::end()
См. также
\Cake\View\ViewBlock::end()false
© 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.ViewBlock.html