Essa tag não é padrão do HTML, ela foi criada utilizando componentes de marcação como a documentação do FreeMarker explica.
Respondendo sua pergunta:
Você usa tags FTL para chamar diretivas . No exemplo, você chamou a listdiretiva. Sintaticamente você fez isso com duas tags: <#list (pageRender.getInstancesIds("SlotB"))! as id>
e </#list>
.
Existem dois tipos de tags FTL:
Start-tag: <#directivename parameters>
Tag final: </#directivename>
Isso é semelhante à sintaxe HTML ou XML, exceto pelo nome da tag que começa com #. Se a diretiva não tiver conteúdo aninhado (conteúdo entre a tag inicial e a tag final), você deverá usar a tag inicial sem tag final. Por exemplo, você escreve <#if something>...</#if>
, mas assim <#include something>
o FreeMarker sabe que a diretiva include
não pode ter um conteúdo aninhado.
O formato dos parameters depende do directivename.
Na verdade, existem dois tipos de diretivas: diretivas predefinidas e diretivas definidas pelo usuário . Para diretivas definidas pelo usuário, você usa @
em vez de #
, por exemplo <@mydirective parameters>...</@mydirective>
. Outra diferença é que, se a diretiva não tiver conteúdo aninhado, você deve usar uma tag como <@mydirective parameters />
, da mesma forma que em XML (por exemplo <img ... />
).
Tags FTL, como tags HTML, devem ser aninhadas corretamente. Portanto, o código abaixo está errado, pois a ifdiretiva está dentro e fora do conteúdo aninhado da list diretiva:
<ul>
<#list animals as animal>
<li>${animal.name} for ${animal.price} Euros
<#if user == "Big Joe">
(except for you)
</#list> <#-- WRONG! The "if" has to be closed first. -->
</#if>
</ul>
Referências em: