Synopsis
<#if condition>
...
<#elseif condition2>
...
<#elseif condition3>
...
...
<#else>
...
</#if>
Where:
-
condition,condition2, ...etc.: Expression evaluates to a boolean value.
The elseif-s and the
else are optional.
Camel case name variant: elseIf
Description
You can use if, elseif
and else directives to conditionally skip a
section of the template. The
condition-s must
evaluate to a boolean value, or else an error will abort template
processing. The elseif-s and
else-s must occur inside if
(that is, between the if start-tag and end-tag).
The if can contain any number of
elseif-s (including 0) and at the end optionally
one else. Examples:
if with 0 elseif and no
else:
<#if x == 1> x is 1 </#if>
if with 0 elseif and
else:
<#if x == 1> x is 1 <#else> x is not 1 </#if>
if with 2 elseif and no
else:
<#if x == 1> x is 1 <#elseif x == 2> x is 2 <#elseif x == 3> x is 3 </#if>
if with 3 elseif and
else:
<#if x == 1> x is 1 <#elseif x == 2> x is 2 <#elseif x == 3> x is 3 <#elseif x == 4> x is 4 <#else> x is not 1 nor 2 nor 3 nor 4 </#if>
To see more about boolean expressions, see: Template Author's Guide/The Template/Expressions.
You can nest if directives (of
course):
<#if x == 1>
x is 1
<#if y == 1>
and y is 1 too
<#else>
but y is not
</#if>
<#else>
x is not 1
<#if y < 0>
and y is less than 0
</#if>
</#if> When you want to test if x > 0 or
x >= 0, writing <#if x >
0> and <#if x >= 0> is
WRONG, as the first > will close the
#if tag. To work that around, write
<#if x gt 0> or <#if gte
0>. Also note that if the comparison occurs inside
parentheses, you will have no such problem, like <#if
foo.bar(x > 0)> works as expected.
