Bricklayer::Templater::Handler - Base class for all Template tag handlers
Bricklayer::Templater::Handler does all the common heavy lifting that a Template tag handler needs to do. It initialize the handler object and sets up the callback hooks that are needed.
$self->app() returns the template engine
$self->attributes() returns a hashref of tag attributes. tag attributes are specified the same way that xml attributes are with the following restrictions.
$self->block() returns the text block contents of the tag. The bricklayer parser is not recursive on its own. If you tag is expected to process the block as more template text then you should call parse_block() as shown below.
$self->type() returns the tag type. This shoule be either 'block' or 'single' or 'text'. You probably will never need to use this.
$self->tagname() returns the tag's name. This should be the classname minus the Bricklayer::Templater::Handler:: part.
$self->tagid() returns the template engines current template tag identifier. It is equivalent to calling $self->app()->identifier.
Bricklayer::Templater::Handler::tag::name->load() is the constructor for a tag handler. it will get passed a Token data structure and the Template engine object as a context.
$self->parse_block($arg) is a convenience function that will run the templater on the block with any argument you pass in to it.
$handler->run_handler() is what the engine calls to actually run the handler. You probably shouldn't be using this method since it's mostly for internal use.