autoesc

Page Contents

• Synopsis

• Description

Synopsis

<#autoesc>
  ...
</#autoesc>

骆驼的案例名称变体：autoEsc

Description

在嵌套部分中打开auto-escaping。如果当前output format默认情况下具有自动转义功能，则通常默认情况下会启用自动转义功能，因此您很少需要此功能。请注意，要仅转义禁用自动转义的单个${expression}，应改用${expression?esc}。

该指令仅对嵌套模块中的字面部分(如文本编辑器中)有效，而对从那里调用/包含的部分无效。

Example:

<#ftl output_format="XML" auto_esc=false>
${"&"}
<#autoesc>
  ${"&"}
  ...
  ${"&"}
</#autoesc>
${"&"}

&
  &
  ...
  &
&

autoesc不能用于当前output format是非标记输出格式的地方(因此无法转义)。这样做是parse-time error。

也可以使用autoesc嵌套在noautoesc directive中来重新启用自动转义。

autoesc可用于已启用自动转义的地方，例如甚至在另一个autoesc块内部。这样做是多余的，但允许这样做。