Transform directive

Page Contents

Synopsis

<transform transVar>
  ...
</transform>
or
<transform transVar name1=value1 name2=value2 ... nameN=valueN>
  ...
</transform>

Where:

  • transVar:表达式求值为变换

  • name1name2,... nameN:参数名称。字面价值,不是表达。

  • value1value2,... valueN:表达式的计算结果为参数值

Description

Note:

该指令仍然有效,但已弃用。您可能需要阅读有关用户定义的指令调用的信息,以查看替换内容。

捕获在其主体内部(即在其开始标签和结束标签之间)生成的输出,并让给定的转换对其进行修改,然后再将其写入最终输出。

Example:

<p>A very simple HTML file:
<pre>
<transform html_escape>
<html>
  <body>
    <p>Hello word!
  </body>
</html>
</transform>
</pre>

输出将是:

<p>A very simple HTML file:
<pre>
&lt;html&gt;
  &lt;body&gt;
    &lt;p&gt;Hello word!
  &lt;/body&gt;
&lt;/html&gt;
</pre>

一些转换可能会带参数。参数的名称和含义取决于所讨论的转换。例如,在这里,我们提供一个名为“ var”的参数:

<#-- This transform stores the output in the variable x,
     rather than sending it to the output -->
<transform capture_output var="x">
some test
</transform>

程序员的任务是将必要的转换放入数据模型中。有关可访问转换的名称和用法,请询问程序员。最初,freemarker.template.utility包中的大多数转换都为shared variable。有关更多信息,请参见:程序员指南/配置/共享变量