isdecorate Element

Decorate the enclosed content with the contents of the specified (decorator) template.

Syntax

<isdecorate template="template_name">
  <!-- ... -->
</isdecorate>

template

Required

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.