不做浮躁的人
正在行走的人...
posts - 77,  comments - 51,  trackbacks - 0
一:if指令:
<#if condition>
 
...
<#elseif condition2>
 
...
<#elseif condition3>
 
...
...
<#else>
 
...
</#if>

二:switch
<#switch value>
  <#case
refValue1>
   
...
    <#break>
  <#case
refValue2>
   
...
    <#break>
 
...
  <#case refValueN>
   
...
    <#break>
  <#default>
   
...
</#switch>

三:list,break
<#list sequence as item>
    ...
</#list>
两个特殊的循环变量:
item_index: 当前变量的索引值。
item_has_next: 是否存在下一个对象。

可以用<#break/>指令离开loop循环。

四:include指令
<#include filename>
或者
<#include filenameoptions>


filename
: 表达式转换为字符串
options: encoding=encoding, parse=parse
   encoding: 表达式转换为字符串
   parse: 表达式转换为逻辑值,是否作为ftl文件解析。
<#include "/common/navbar.html" parse=false encoding="Shift_JIS">

<#include "*/footer.ftl">表示当前目录下以及所有父目录下的文件。
如果当前模版在/foo/bar/template.ftl ,那么查找footer.ftl的顺序为:
/foo/bar/footer.ftl
/foo/footer.ftl
/footer.ftl
这种方式讲允许设计者将通用的模版放在父文件夹里面。
也可以只指定部分路径:<#include "*/commons/footer.ftl">

五:import指令
<#import path as hash>
六:noparse
<#noparse>
  ...
</#noparse>

七:compress
<#compress>
  ...
</#compress>
八:escape,noescape
<#escape identifier as expression>
  ...
  <#noescape>...</#noescape>
  ...
</#escape>

escape指令body区的ftl的interpolations都会被自动加上escape表达式。但是不会影响字符串内的interpolations。而且也只会影响到body内出现的interpolations,比如不会影响到include的ftl的interpolations。

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

First name: ${firstName?html}
  Last name: ${lastName?html}
  Maiden name: ${maidenName?html}

escape指令在解析模版时起作用,而不是运行时起作用。

escape指令还能嵌套使用,子继承父的escape规则。

<#escape x as x?html>
  Customer Name: ${customerName}
  Items to ship:
  <#escape x as itemCodeToNameMap[x]>
    ${itemCode1}
    ${itemCode2}
    ${itemCode3}
    ${itemCode4}
  </#escape>
</#escape>
等同于:
Customer Name: ${customerName?html}
  Items to ship:
    ${itemCodeToNameMap[itemCode1]?html}
    ${itemCodeToNameMap[itemCode2]?html}
    ${itemCodeToNameMap[itemCode3]?html}
    ${itemCodeToNameMap[itemCode4]?html}

九:assign指令
<#assign name=value>
or
<#assign name1=value1name2=value2... nameN=valueN>
or
<#assign same as above... in namespacehash>
or
<#assign name>
  capture this
</#assign>
or
<#assign name in namespacehash>
  capture this
</#assign>

创建或者替换一个已经存在的变量,只能作用于顶层变量。 不好的做法:<#assign x>Hello ${user}!</#assign>
更改为:<#assign x="Hello ${user}!">




十:global指令
<#global name=value>
or
<#global name1=value1name2=value2... nameN=valueN>
or
<#global name>
  capture this
</#global>



十一:local指令
<#local name=value>
or
<#local name1=value1name2=value2... nameN=valueN>
or
<#local name>
  capture this
</#local>
只能用于macro的定义body中。


十二:setting指令:

<#setting name=value>
name的取值范围:
local:
number_format:
boolean_format
:缺省值为"true,false"
date_format, time_format,
datetime_format
time_zone:
url_escaping_charset
classic_compatible

十三:用户自定义指令
<@macro_or_transfparam1=val1param2=val2...paramN=valN/><@macro_or_transfparam1=val1param2=val2...paramN=valN ; lv1, lv2, ..., lvN/><@macro_or_transf...>
  ...
</@macro_or_transf>


<@macro_or_transf...> ... </@>
<@macro_or_transfval1, val2, ..., valN/>

十四:macro,nested,return
<#macro nameparam1param2... paramN>
  ...
  <#nested loopvar1, loopvar2, ..., loopvarN>
  ...
  <#return>
  ...
</#macro>

十五:function, return
<#function nameparam1param2... paramN>
  ... <#return returnValue>
  ...
</#function>

<#function avg x y>
  <#return (x + y) / 2>
</#function>
${avg(10, 20)} 

十六:flush
<#flush>

十七:stop
<#stop>
or
<#stop reason>
取消处理模版。

十八:ftl指令
<#ftl param1=value1param2=value2...paramN=valueN>
ftl指令必须放在ftl文件的最上面。

参数范围:
encoding:
strip_whitespace
strip_text
strict_syntax

十九:t, lt, rt
二十:attempt, recover
<#attempt>
  attempt block
<#recover>  
recover block
</#attempt>

<#attempt>
  Optional content: ${thisMayFails}
<#recover>
  Ops! The optional content is not available.
</#attempt>
posted on 2007-03-27 01:04 不做浮躁的人 阅读(1205) 评论(1)  编辑  收藏 所属分类: freemarker

FeedBack:
# re: freemaker学习笔记--指令参考
2007-04-05 10:18 | huozhe
非常好!
希望楼主继续共享freemark相关文章,谢谢!
我的邮箱:huozheviva@gmail.com  回复  更多评论
  

只有注册用户登录后才能发表评论。


网站导航:
 

<2007年3月>
25262728123
45678910
11121314151617
18192021222324
25262728293031
1234567

常用链接

留言簿(8)

随笔分类(31)

随笔档案(75)

文章分类(1)

文章档案(3)

搜索

  •  

最新评论

阅读排行榜

评论排行榜