au.com.codeka.carrot.tag

Class ElseTag

java.lang.Object

au.com.codeka.carrot.tag.Tag

au.com.codeka.carrot.tag.ElseTag

public class ElseTag
extends Tag

The ElseTag can be chained with IfTag or ForTag to contain the "else" block. In the case if IfTag, it'll be chained to if the if condition is false. In the case of ForTag, it'll be chained to if there are no elements in the list to be iterated.

The ElseTag can have an optional "if <expr>" after if, in which case the tag will basically be like an IfTag that can be chained to. You can then do as many {% if blah %} {% else if blah %}...{% end %} as you like.

Constructor Summary

Constructors

Constructor and Description
ElseTag()

Method Summary

Modifier and Type	Method and Description
boolean	canChain(Tag nextTag) Return true if we can chain to the given next Tag.
boolean	isBlockTag()
void	parseStatement(StatementParser stmtParser) Parse the statement that appears after the tag in the markup.
void	render(CarrotEngine engine, java.io.Writer writer, TagNode tagNode, Scope scope) Render this Tag to the given Writer.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ElseTag

public ElseTag()

Method Detail

isBlockTag

public boolean isBlockTag()

Overrides:

isBlockTag in class Tag

Returns:

True if this is a "block" tag, meaning it contains child content (in the form of a list of Nodes) and false if this is not a block tag (e.g. it's just a single inline element or something).

canChain

public boolean canChain(Tag nextTag)

Return true if we can chain to the given next Tag. If it's another else tag then we can chain to it.

Overrides:

canChain in class Tag

Parameters:

nextTag - The next Tag that we want to check whether we can chain to.

Returns:

True if we can chain to the next tag.

parseStatement

public void parseStatement(StatementParser stmtParser)
                    throws CarrotException

Description copied from class: Tag

Parse the statement that appears after the tag in the markup. This is guaranteed to be called before Tag.isBlockTag() or Tag.canChain(Tag).

Overrides:

parseStatement in class Tag

Parameters:

stmtParser - A StatementParser for parsing the statement.

Throws:

CarrotException - if there is an unrecoverable error parsing the statement.

render

public void render(CarrotEngine engine,
                   java.io.Writer writer,
                   TagNode tagNode,
                   Scope scope)
            throws CarrotException,
                   java.io.IOException

Description copied from class: Tag

Render this Tag to the given Writer.

Overrides:

render in class Tag

Parameters:

engine - The current CarrotEngine.

writer - The Writer to render to.

tagNode - The TagNode that we're enclosed in. You can use this to render the children, or query the children or whatever.

scope - The current Scope.

Throws:

CarrotException - if there's an error parsing or rendering the template

java.io.IOException - when there's an error writing to the Writer (basically this is just passed on from whatever errors the Writer might throw..