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.

Namespace: Cake\View
Located at View/ViewBlock.php

Method Detail

activesource public

active( )

Get the name of the currently open block.

Returns

string|null
Either 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 $value optional null
The content for the block
string $mode optional Cake\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

boolean
bool

getsource public

get( string $name , string $default '' )

Get the content for a block.

Parameters

string $name
Name of the block
string $default optional ''
Default string

Returns

string
The block content or $default if the block does not exist.

keyssource public

keys( )

Get the names of all the existing blocks.

Returns

array
An 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 $mode optional Cake\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\Exception
When starting a block twice

unclosedsource public

unclosed( )

Get the names of the unclosed/active blocks.

Returns

array
An array of unclosed blocks.

Constants summary

string APPEND

Append content

'append'
string OVERRIDE

Override content

'override'
string PREPEND

Prepend content

'prepend'

Properties summary

$_activesource

protected array

The active blocks being captured.

[]

$_blockssource

protected array

Block content. An array of blocks indexed by name.

[]

$_discardActiveBufferOnEndsource

protected boolean

Should the currently captured content be discarded on ViewBlock::end()

See

Cake\View\ViewBlock::end()
false

© 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