Class ViewBlock
ViewBlock implements the concept of Blocks or Slots in the View layer. Slots or blocks are combined with extending views and layouts to afford slots of content that are present in a layout or parent view, but are defined by the child view or elements used in the view.
Method Detail
activesource public
active( )
Get the name of the currently open block.
Returns
string|nullEither null or the name of the last open block.
concatsource public
concat( string $name , mixed $value null , string $mode Cake\View\ViewBlock::APPEND )
Concat content to an existing or new block. Concating to a new block will create the block.
Calling concat() without a value will create a new capturing block that needs to be finished with View::end(). The content of the new capturing context will be added to the existing block context.
Parameters
- string
$name - Name of the block
- mixed
$valueoptional null - The content for the block
- string
$modeoptionalCake\View\ViewBlock::APPEND - If ViewBlock::APPEND content will be appended to existing content. If ViewBlock::PREPEND it will be prepended.
endsource public
end( )
End a capturing block. The compliment to ViewBlock::start()
See
Cake\View\ViewBlock::start()existssource public
exists( string $name )
Check if a block exists
Parameters
- string
$name - Name of the block
Returns
booleanbool
getsource public
get( string $name , string $default '' )
Get the content for a block.
Parameters
- string
$name - Name of the block
- string
$defaultoptional '' - Default string
Returns
stringThe block content or $default if the block does not exist.
keyssource public
keys( )
Get the names of all the existing blocks.
Returns
arrayAn array containing the blocks.
setsource public
set( string $name , mixed $value )
Set the content for a block. This will overwrite any existing content.
Parameters
- string
$name - Name of the block
- mixed
$value - The content for the block.
startsource public
start( string $name , string $mode Cake\View\ViewBlock::OVERRIDE )
Start capturing output for a 'block'
Blocks allow you to create slots or blocks of dynamic content in the layout. view files can implement some or all of a layout's slots.
You can end capturing blocks using View::end(). Blocks can be output using View::get();
Parameters
- string
$name - The name of the block to capture for.
- string
$modeoptionalCake\View\ViewBlock::OVERRIDE - If ViewBlock::OVERRIDE existing content will be overridden by new content. If ViewBlock::APPEND content will be appended to existing content. If ViewBlock::PREPEND it will be prepended.
Throws
Cake\Core\Exception\ExceptionWhen starting a block twice
unclosedsource public
unclosed( )
Get the names of the unclosed/active blocks.
Returns
arrayAn array of unclosed blocks.
Constants summary
string | APPEND Append content | 'append' |
string | OVERRIDE Override content | 'override' |
string | PREPEND Prepend content | 'prepend' |
Properties summary
© 2005–2016 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.
http://api.cakephp.org/3.1/class-Cake.View.ViewBlock.html