FreeMarker 用户自定义指令@(3.4)

调用方法：

①<@user_def_dir_exp param1=val1 param2=val2 ... paramN=valN/> （xml风格）
②<@user_def_dir_exp param1=val1 param2=val2 ... paramN=valN ;lv1, lv2, ..., lvN/> （包含循环变量）
③<@user_def_dir_exp ...>...</@user_def_dir_exp>（使用结束标签1）
④<@user_def_dir_exp ...>...</@>（使用结束标签2）

说明：

user_def_dir_exp:表达式算作是自定义指令（比如宏），将会被调用。
param1,param2 等:参数的名称，它们不是表达式。
val1,val2 等:参数的值，它们是表达式。
lv1,lv2 等:循环变量的名称，它们不是表达式。

参数的数量可以是 0（也就是没有参数）。参数的顺序并不重要（除非你使用了位置参数传递）。参数名称必须唯一。在参数名中小写和大写的字母被认为是不同的字母（也就是 Color 和 color 是不同的）。
调用有参数的宏：

<@list items=["mouse", "elephant", "python"] title="Animals"/>
...
<#macro list title items>
<p>${title?cap_first}:
<ul>
<#list items as x>
<li>${x?cap_first}
</#list>
</ul>
</#macro>

结束标签：

你可以在结束标签中忽略 user_def_dir_exp 。也就是说，你可以写 </@> 来替代</@anything> 。这个规则当表达式 user_def_dir_exp 太复杂时非常有用，因为你不需要在结束标签中重复表达式。

位置参数传递：

位置参数传递（如 <@heading "Preface", 1/> ）是正常命名参数传递（如<@heading title="Preface" level=1/> ）的速记形式，这里忽略了参数的名称。如果自定义指令只有一个参数，或者对于经常使用的自定义指令它参数的顺序很好记忆，速记形式应该被应用。如果你使用参数名称，那顺序就不重要了。

循环变量：

自定义指令创建循环变量（和 list 指令相似）。当你调用指令（如 <#list foos as foo>...</#list> 中的 foo ）时循环变量的名称就给定了，而变量的值是由指令本身设置的。在自定义指令的情形下，语法是循环变量的名称在分号之后给定。

<#macro repeat count>
<#list 1..count as x>
<#nested x, x/2, x==count>
</#list>
</#macro><@repeat count=4 ; c, halfc, last>
${c}. ${halfc}<#if last> Last!</#if>
</@repeate><@repeat count=4 ; x, last>
${x}. Something... <#if last> This was the last!</#if>

注意由自定义指令创建的循环变量数量和分号之后指定的循环变量数量需要不匹配。也就是说，如果你对重复是否是最后一个不感兴趣，你可以简单来写：

<@repate count=4 ; x>
${x}. Something...
</@repate >

或者
<@repeat count=4>
Something...
</@repeat >

转载于:https://www.cnblogs.com/kjitboy/p/5094341.html

FreeMarker 用户自定义指令@(3.4)相关推荐

java中Freemarker list指令详解
java Freemarker中list指令主要是进行迭代服务器端传递过来的List集合. 定义 <#list nameList as names> ${names} </#list ...
freemarker基本指令用法
freemarker基本指令用法 1.if指令 //第一种用法 [#if 条件] ... [/#if] //第二种用法[#if 条件]...[#else]... [/#if]//第三种用法[#if 条 ...
freemarker自定义指令及方法
"一节复一节,千枝攒万叶"竹子每生长一段就会总结一下打个节,今天我也总结一下最近处理的一个小问题,希望我的小节,对各位看官有所帮助. 背景描述: 最近项目做了一个月报功能,由于生产 ...
Freemarker If指令
if 指令即判断指令,是常用的FTL指令,freemarker在解析时遇到if会进行判断,条件为真则输出if中间的内容,否则跳过内容不再输出. 模板: <!DOCTYPE html> &l ...
freemarker -自定义指令
自定义指令可以使用,Marco指令来进行定义宏是有一个变量名的模板片段,在模板中使用宏作为自定义指令,这样就能供其他页面使用. <#macro greet><font size= ...
freemarker,自定义指令
一,自定义指令 <#-- 自定义指令 --> <#macro mycommand1>我的第一个自定义指令 </#macro> <#-- 调用自定义带参数的指令 ...
Freemarker 简介及手册
FreeMarker 手册什么是FreeMarker? FreeMarker是一款模板引擎:即一种基于模板.用来生成输出文本(任何来自于HTML格式的文本用来自动生成源代码)的通用工具.它是为Jav ...
freemarker指令(九)
Freemarker指令如果你没有在这里发现模板中的指令,可能你需要在废弃的 FTL 结构中来查找它了. 2.1 if ,else ,elseif 指令 2.1.1 概要 <#if con ...
FreeMarker中文帮助手册API文档,基础入门学习文档
FreeMarker中文帮助手册API文档,基础入门学习文档分类: 编程技术发布: bywei 浏览: 7 日期: 2011年5月28日分享到: QQ空间新浪微博腾讯微博人人网什么是Fr ...

FreeMarker 用户自定义指令@(3.4)

FreeMarker 用户自定义指令@(3.4)相关推荐

最新文章

热门文章