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.
Copyright: Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
License: License (http://www.opensource.org/licenses/mit-license.php)
Location: Cake/View/ViewBlock.php
Properties summary
Method Summary
-
active() public
Get the name of the currently open block. -
append() public
Append to an existing or new block. Appending to a new block will create the block.
-
end() public
End a capturing block. The compliment to ViewBlock::start() -
get() public
Get the content for a block. -
keys() public
Get the names of all the existing blocks. -
set() public
Set the content for a block. This will overwrite any existing content.
-
start() public
Start capturing output for a 'block' -
unclosed() public
Get the names of the unclosed/active blocks.
Method Detail
active() public ¶
active( )
Get the name of the currently open block.
Returns
Either null or the name of the last open block.
append() public ¶
append( string $name , string $value = null )
Append to an existing or new block. Appending to a new block will create the block.
Calling append() 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
- string $value optional null
- The content for the block.
Throws
end() public ¶
end( )
End a capturing block. The compliment to ViewBlock::start()
See
get() public ¶
get( string $name )
Get the content for a block.
Parameters
- string $name
- Name of the block
Returns
block content or '' if the block does not exist.
keys() public ¶
keys( )
Get the names of all the existing blocks.
Returns
An array containing the blocks.
set() public ¶
set( string $name , string $value )
Set the content for a block. This will overwrite any existing content.
Parameters
- string $name
- Name of the block
- string $value
- The content for the block.
Throws
start() public ¶
start( string $name )
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.
unclosed() public ¶
unclosed( )
Get the names of the unclosed/active blocks.
Returns
An array of unclosed blocks.