Conditional Tags
Sometimes, you only want to output a section of the template if a piece of content has been given. For example, if no heading content has been given, you don’t want to output a set of empty <h2></h2>
tags. This is where conditionals come in. Here’s an example:
<perch:if exists="heading">
<h2>
<perch:content id="heading" type="text" label="Heading" required="false">
</h2>
</perch:if>
The above example will only output the HTML inside the tags if a value has been entered for the heading. You can wrap the conditional tags around any part of the template, and you may include one conditional tag inside another.
The conditional tags if
and else
allow you to check a condition and do one thing or another based on it matching or not.
The conditional tags every
, before
and after
are for use with repeating elements - templates that repeat in multiple item regions, Repeaters and Blocks.
Available conditional tags
Tag | Description |
---|---|
if |
check to see if a condition is true |
else |
use with if to define what happens if that does not match |
every |
Do something (for example add a class) every certain number of repeats |
before |
Do something before outputting a repeat section |
after |
Do something after outputting a repeat section |