isdecorate Element
Decorate the enclosed content with the contents of the specified (decorator) template.
Syntax
<isdecorate
template = template_name //required
>
...
</isdecorate>
- template = template_name
-
Allowed data type: string or expression.
template_name
is the name of the decorator template that is used to decorate the contents.
Purpose
The decorator template
has the tag <isreplace/>
identifying where the
decorated content shall be included. Typically, only one tag
(<isreplace/>
) is used in the decorator template.
However, multiple or zero <isreplace/>
tags can
also be used. If the decorating template doesn't have an
<isreplace/>
tag, the decorated content is omitted
from the resultant output. If the decorator template has multiple
<isreplace/>
tags, the content to be decorated will
be included for each <isreplace/>
tag.
A typical use case is to decorate the content body with a header and footer.
Example
The decorator tags can be nested to an arbitrary depth, for example:
<isdecorate template="mytemplate">
...
<isdecorate template="mytemplate"
...
</isdecorate>
</isdecorate>
Different decorator
templates can be used in different <isdecorate/>
tags, both in nested and non-nested scenarios.