freemarker参数详解

◆ Freemarker 标签完全解析

1. assign 

assign指令在前面已经使用了多次,它用于为该模板页面创建或替换一个顶层变量,assign指令的用法有多种,包含创建或替换一个顶层变量,或者创建或替换多个变量等。

 

示范代码：

<#assign x>

<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as n>

${n}

</#list>

</#assign>

更多 assign 信息

2. break 

<#break>指令用于跳出迭代

例子如下:

<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as x>
${x_index + 1}.${x}<#if x_has_next>,</if>
<#if x="星期四"><#break></#if>
</#list>

更多 break 信息

3. case 

switch , case , default , break这些指令显然是分支指令,作用类似于Java的switch语句,switch指令的语法结构如下:

<#switch x>

<#case x = 1>

     1

<#case x = 2>

     2

<#default>

     d

</#switch>

如果x=1 输出 1 2, x=2输出 2, x=3 输出d

更多 case 信息

4. default 

switch , case , default , break这些指令显然是分支指令,作用类似于Java的switch语句,switch指令的语法结构如下:

<#switch x>
<#case x = 1>

     1

<#case x = 2>
     2

<#default>
     d

</#switch>

如果x=1 输出 1 2, x=2输出 2, x=3 输出d

更多 default 信息

4. else 

这是一个典型的分支控制指令,该指令的作用完全类似于Java语言中的if,if指令的语法格式如下:

例子如下:

<#assign age=23>

<#if (age>60)>老年人

<#elseif (age>40)>中年人

<#elseif (age>20)>青年人

<#else> 少年人

</#if>

更多 else 信息

5. elseif 

这是一个典型的分支控制指令,该指令的作用完全类似于Java语言中的if,if指令的语法格式如下:
例子如下:
<#assign age=23>
<#if (age>60)>老年人
<#elseif (age>40)>中年人
<#elseif (age>20)>青年人
<#else> 少年人
</#if>

更多 elseif 信息

6. escape 

escape指令导致body区的插值都会被自动加上escape表达式,但不会影响字符串内的插值,只会影响到body内出现的插值。

示范代码：

<#escape x as x?html>
First name:${firstName}
Last name:${lastName}
Maiden name:${maidenName}
</#escape>

更多 escape 信息

7. if 

这是一个典型的分支控制指令,该指令的作用完全类似于Java语言中的if,if指令的语法格式如下:
例子如下:
<#assign age=23>
<#if (age>60)>老年人
<#elseif (age>40)>中年人
<#elseif (age>20)>青年人
<#else> 少年人
</#if>

更多 if 信息

8. import 

该指令用于导入FreeMarker模板中的所有变量,并将该变量放置在指定的Map对象中。

示范代码：

<#import "/libs/mylib.ftl" as my>

更多 import 信息

8. include 

include指令的作用类似于JSP的包含指令,用于包含指定页。

示范代码：

<#include "/common/copyright.ftl" encoding=”GBK”>

 更多 include 信息

9. list 

list指令是一个迭代输出指令,用于迭代输出数据模型中的集合。

示范代码：

<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as x>
${x_index + 1}.${x}<#if x_has_next>,</if>
<#if x="星期四"><#break></#if>
</#list>

 更多 list 信息

10. macro 

macro可以用于实现自定义指令,通过使用自定义指令,可以将一段模板片段定义成一个用户指令。

示范代码：

<#macro book booklist>     //定义一个自定义指令booklist是参数
<#list booklist as book>
   ${book}
</#list>
</#macro>

 更多 macro 信息

11. nested 

和macro标签一起使用， 在nested指令中使用循环变量时,可以使用多个循环变量,看如下代码:
<#macro repeat count>
<#list 1..count as x>     //使用nested指令时指定了三个循环变量
   <#nested x, x/2, x==count>
</#list>
</#macro>
<@repeat count=4 ; c halfc last>
${c}. ${halfc}<#if last> Last! </#if>
</@repeat>

更多 nested 信息

12. noescape 

对于放在escape指令中所有的插值而言,这此插值将被自动加上escape表达式,如果需要指定escape指令中某些插值无需添加escape表达式,则应该使用noescape指令,放在noescape指令中的插值将不会添加escape表达式.

示范代码：

<#escape x as x?html>

First name:${firstName}

<#noescape>Last name:${lastName}</#noescape>

Maiden name:${maidenName}

</#escape>

更多 noescape 信息

13. noparse 

noparse指令指定FreeMarker不处理该指定里包含的内容。

示范代码：

<#noparse>

<#list books as book>

   <tr><td>${book.name}<td>作者:${book.author}

</#list>

</#noparse>

 更多 noparse 信息

14. return 

return指令用于结束macro指令,一旦在macro指令中执行了return指令,则FreeMarker不会继续处理macro指令里的内容,看如下代码:
<#macro book>
spring
<#return>
j2ee
</#macro>
<@book />
上面的代码输出:spring,而j2ee位于return指令之后,不会输出.

更多 return 信息

16. setting 

用来设置整个系统的一个环境。

示范代码：

${1.2}

<#setting locale="en_US">

${1.2}

输出

1,2

1.2

 更多 setting 信息

17. switch 

switch , case , default , break这些指令显然是分支指令,作用类似于Java的switch语句,switch指令的语法结构如下:

<#switch x>

<#case x = 1>

     1

<#case x = 2>

     2

<#default>

     D

</#switch>

如果x=1 输出 1 2, x=2输出 2, x=3 输出d

更多 switch 信息

18. 字符串处理 

各种处理字符串的方法，有：

html安全输出、substring的用法、类似String.split的用法、取得字符串长度、大写输出字符、小写输出字符、首字符大写、首字符小写、去掉字符串前后空格、每个单词的首字符大写、类似String.indexof:、类似String.lastIndexOf 、替换字符串 replace等

更多 字符串处理 信息

19. 对象是不是null 

判断对象是不是null     <#if mouse?exists>

       Mouse found

<#else>

也可以直接${mouse?if_exists})输出布尔形

更多 对象是不是null 信息