1、字符輸出

${emp.name?if_exists}　　　　　　// 變量存在，輸出該變量，否則不輸出 ${emp.name!}　　　　　　　　　　 // 變量存在，輸出該變量，否則不輸出 ${emp.name?default("xxx")} // 變量不存在，取默認(rèn)值xxx ${emp.name!"xxx"} 　　　　　　// 變量不存在，取默認(rèn)值xxx ${"123<br>456"?html} 　　// 對(duì)字符串進(jìn)行HTML編碼，對(duì)html中特殊字符進(jìn)行轉(zhuǎn)義 ${"str"?cap_first} 　　 // 使字符串第一個(gè)字母大寫 ${"Str"?lower_case} // 將字符串轉(zhuǎn)換成小寫 ${"Str"?upper_case} // 將字符串轉(zhuǎn)換成大寫 ${"str"?trim} // 去掉字符串前后的空白字符 ${"hello${emp.name!}"} // 輸出hello+變量名 ${"hello"+emp.name!} // 使用+號(hào)來連接，輸出hello+變量名 <#assign str = "abcdefghijklmn"/>// 方法1 ${str?substring(0,4)} // 輸出abcd// 方法2 ${str[0]}${str[4]} // 結(jié)果是ae ${str[1..4]} 　　　 // 結(jié)果是bcde// 返回指定字符的索引 ${str?index_of("n")}

2、日期輸出

${emp.date?string('yyyy-MM-dd')} //日期格式

3、數(shù)字輸出

${emp.name?string.number} 　// 輸出20 ${emp.name?string.currency} // ￥20.00 ${emp.name?string.percent} // 20% ${1.222?int} 　　　　　　　　　　 // 將小數(shù)轉(zhuǎn)為int，輸出1<#setting number_format="percent"/> // 設(shè)置數(shù)字默認(rèn)輸出方式('percent',百分比) <#assign answer=42/> 　　　　　　　　 // 聲明變量 answer 42 #{answer} 　　　　　　　　 // 輸出 4,200% ${answer?string} 　　　　 // 輸出 4,200% ${answer?string.number} 　　// 輸出 42 ${answer?string.currency} // 輸出 ￥42.00 ${answer?string.percent} 　// 輸出 4,200% #{answer} 　　　　　　　　// 輸出 42

//數(shù)字格式化插值可采用#{expr;format}形式來格式化數(shù)字,其中format可以是:
//mX:小數(shù)部分最小X位
//MX:小數(shù)部分最大X位 如下面的例子: <#assign x=2.582/> <#assign y=4/> #{x; M2} // 輸出2.58 #{y; M2} // 輸出4 #{x; m2} // 輸出2.58 #{y; m2} // 輸出4.0 #{x; m1M2} // 輸出2.58 #{x; m1M2} // 輸出4.0

4、申明變量

<#assign foo=false/> // 聲明變量,插入布爾值進(jìn)行顯示,注意不要用引號(hào) ${foo?string("yes","no")} // 當(dāng)為true時(shí)輸出"yes",否則輸出"no" <#assign name=value> <#assign name1=value1 name2=value2 ... nameN=valueN> <#assign same as above... in namespacehash><#assign name> capture this </#assign><#assign name in namespacehash> capture this </#assign>

5、比較運(yùn)算符

表達(dá)式中支持的比較運(yùn)算符有如下幾個(gè): = 或 == ：判斷兩個(gè)值是否相等. != ：判斷兩個(gè)值是否不等. > 或 gt ：判斷左邊值是否大于右邊值 >= 或 gte ：判斷左邊值是否大于等于右邊值 < 或 lt ：判斷左邊值是否小于右邊值 <= 或 lte ：判斷左邊值是否小于等于右邊值

6、算術(shù)運(yùn)算符

FreeMarker表達(dá)式中完全支持算術(shù)運(yùn)算, FreeMarker支持的算術(shù)運(yùn)算符包括:+, - , * , / , % 注意： （1）、運(yùn)算符兩邊必須是數(shù)字 （2）、使用+運(yùn)算符時(shí),如果一邊是數(shù)字,一邊是字符串,就會(huì)自動(dòng)將數(shù)字轉(zhuǎn)換為字符串再連接,如:${3 + "5"},結(jié)果是:35

7、邏輯運(yùn)算符

邏輯運(yùn)算符有如下幾個(gè): 邏輯與:&& 邏輯或:|| 邏輯非:! 邏輯運(yùn)算符只能作用于布爾值,否則將產(chǎn)生錯(cuò)誤

8、運(yùn)算符優(yōu)先級(jí)如下(由高到低排列):

①、一元運(yùn)算符:! ②、內(nèi)建函數(shù):? ③、乘除法:*, / , % ④、加減法:- , + ⑤、比較:> , < , >= , <= (lt , lte , gt , gte) ⑥、相等:== , = , != ⑦、邏輯與:&& ⑧、邏輯或:|| ⑨、數(shù)字范圍:..

9、if 邏輯判斷

<#if condition> ... <#elseif condition2> ... <#elseif condition3> ... <#else> ... </#if> // 當(dāng) photoList 不為空時(shí) <#if photoList??>...</#if> 值得注意的是,${..}只能用于文本部分,不能用于表達(dá)式,下面的代碼是錯(cuò)誤的: <#if ${isBig}>Wow!</#if> <#if "${isBig}">Wow!</#if>// 正確寫法 <#if isBig>Wow!</#if>

10、switch

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

11、集合 & 循環(huán)

// 遍歷集合: <#list empList! as emp> ${emp.name!} </#list>// 可以這樣遍歷集合: <#list 0..(empList!?size-1) as i>${empList[i].name!} </#list>// 與jstl循環(huán)類似,也可以訪問循環(huán)的狀態(tài)。 empList?size 　　　// 取集合的長(zhǎng)度 emp_index: 　　　　// int類型，當(dāng)前對(duì)象的索引值 emp_has_next: // boolean類型，是否存在下一個(gè)對(duì)象// 使用<#break>跳出循環(huán) <#if emp_index = 0><#break></#if>// 集合長(zhǎng)度判斷 <#if empList?size != 0></#if> // 判斷=的時(shí)候,注意只要一個(gè)=符號(hào),而不是==<#assign l=0..100/> // 定義一個(gè)int區(qū)間的0~100的集合，數(shù)字范圍也支持反遞增,如100..2 <#list 0..100 as i> 　　// 等效于java for(int i=0; i <= 100; i++) 　　${i} </#list>// 截取子集合： empList[3..5] //返回empList集合的子集合,子集合中的元素是empList集合中的第4-6個(gè)元素// 創(chuàng)建集合： <#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as x>// 集合連接運(yùn)算,將兩個(gè)集合連接成一個(gè)新的集合 <#list ["星期一","星期二","星期三"] + ["星期四","星期五","星期六","星期天"] as x>// 除此之外,集合元素也可以是表達(dá)式,例子如下: [2 + 2, [1, 2, 3, 4], "whatnot"]// seq_contains：判斷序列中的元素是否存在 <#assign x = ["red", 16, "blue", "cyan"]> ${x?seq_contains("blue")?string("yes", "no")} // yes ${x?seq_contains("yellow")?string("yes", "no")} // no ${x?seq_contains(16)?string("yes", "no")} // yes ${x?seq_contains("16")?string("yes", "no")} // no// seq_index_of：第一次出現(xiàn)的索引 <#assign x = ["red", 16, "blue", "cyan", "blue"]> ${x?seq_index_of("blue")} // 2// sort_by：排序（升序） <#list movies?sort_by("showtime") as movie></#list>// sort_by：排序（降序） <#list movies?sort_by("showtime")?reverse as movie></#list>// 具體介紹： // 不排序的情況： <#list movies as moive><a href="${moive.url}">${moive.name}</a> </#list>//要是排序，則用 <#list movies?sort as movie><a href="${movie.url}">${movie.name}</a> </#list>// 這是按元素的首字母排序。若要按list中對(duì)象元素的某一屬性排序的話，則用 <#list moives?sort_by(["name"]) as movie><a href="${movie.url}">${movie.name}</a> </#list>//這個(gè)是按list中對(duì)象元素的[name]屬性排序的，是升序，如果需要降序的話，如下所示： <#list movies?sort_by(["name"])?reverse as movie><a href="${movie.url}">${movie.name}</a> </#list>

12、Map對(duì)象

// 創(chuàng)建map <#assign scores = {"語文":86,"數(shù)學(xué)":78}>// Map連接運(yùn)算符 <#assign scores = {"語文":86,"數(shù)學(xué)":78} + {"數(shù)學(xué)":87,"Java":93}>// Map元素輸出 emp.name // 全部使用點(diǎn)語法 emp["name"] // 使用方括號(hào)

13、轉(zhuǎn)義字符:

\" ：雙引號(hào)(u0022) \' ：單引號(hào)(u0027) \\ ：反斜杠(u005C) \n ：換行(u000A) \r ：回車(u000D) \t ：Tab(u0009) \b ：退格鍵(u0008) \f ：Form feed(u000C) \l ：< \g ：> \a ：& \{ ：{ \xCode ：直接通過4位的16進(jìn)制數(shù)來指定Unicode碼,輸出該unicode碼對(duì)應(yīng)的字符.如果某段文本中包含大量的特殊符號(hào),FreeMarker提供了另一種特殊格式:可以在指定字符串內(nèi)容的引號(hào)前增加r標(biāo)記,在r標(biāo)記后的文件將會(huì)直接輸出.看如下代碼: ${r"${foo}"} // 輸出 ${foo} ${r"C:/foo/bar"} // 輸出 C:/foo/bar

14、include指令

// include指令的作用類似于JSP的包含指令: <#include "/test.ftl" encoding="UTF-8" parse=true>// 在上面的語法格式中,兩個(gè)參數(shù)的解釋如下: encoding="GBK" // 編碼格式 parse=true 　　 // 是否作為ftl語法解析,默認(rèn)是true，false就是以文本方式引入,注意:在ftl文件里布爾值都是直接賦值的如parse=true,而不是parse="true"

15、import指令

// 類似于jsp里的import,它導(dǎo)入文件，然后就可以在當(dāng)前文件里使用被導(dǎo)入文件里的宏組件 <#import "/libs/mylib.ftl" as my> // 上面的代碼將導(dǎo)入/lib/common.ftl模板文件中的所有變量,交將這些變量放置在一個(gè)名為com的Map對(duì)象中，"my"在freemarker里被稱作namespace

17、compress 壓縮

// 用來壓縮空白空間和空白的行 <#compress> ... </#compress><#t> // 去掉左右空白和回車換行 <#lt>// 去掉左邊空白和回車換行 <#rt>// 去掉右邊空白和回車換行 <#nt>// 取消上面的效果

18、escape,noescape 對(duì)字符串進(jìn)行HTML編碼

// escape指令導(dǎo)致body區(qū)的插值都會(huì)被自動(dòng)加上escape表達(dá)式,但不會(huì)影響字符串內(nèi)的插值,只會(huì)影響到body內(nèi)出現(xiàn)的插值,使用escape指令的語法格式如下: <#escape x as x?html> First name: ${firstName} <#noescape>Last name: ${lastName}</#noescape> Maiden name: ${maidenName} </#escape>// 相同表達(dá)式 First name: ${firstName?html} Last name: ${lastName} Maiden name: ${maidenName?html} global全局賦值語法 <#global name=value> <#global name1=value1 name2=value2 ... nameN=valueN> <#global name> capture this </#global>// 利用這個(gè)語法給變量賦值，那么這個(gè)變量在所有的namespace中是可見的，如果這個(gè)變量被當(dāng)前的assign語法覆蓋如<#global x=2><#assign x=1>在當(dāng)前頁面里x=2將被隱藏，或者通過${.globals.x} 來訪問 setting 語法 // 用來設(shè)置整個(gè)系統(tǒng)的一個(gè)環(huán)境 locale // zh_CN 中文環(huán)境 number_format boolean_format date_format , time_format , datetime_format time_zone classic_compatible // 例1： <#setting number_format="percent"/> // 設(shè)置數(shù)字默認(rèn)輸出方式('percent',百分比)// 例2： // 假如當(dāng)前是匈牙利的設(shè)置，然后修改成美國 ${1.2} // 輸出1,2 <#setting locale="en_US"> ${1.2} // 輸出1.2,因?yàn)樾傺览遣捎?#34;, "作為十進(jìn)制的分隔符，美國是用". " macro宏指令 <#-- 定義宏 --> <#macro test foo bar="Bar" baaz=-1> Text: ${foo}, ${bar}, ${baaz} </#macro><#-- 使用宏 --> <@test foo="a" bar="b" baaz=5*5/> // 輸出：Text: a, b, 25 <@test foo="a" bar="b"/> 　　　　// 輸出：Text: a, b, -1 <@test foo="a" baaz=5*5-2/> 　　　　// 輸出：Text: a, Bar, 23 <@test foo="a"/> // 輸出：Text: a, Bar, -1<#-- 定義一個(gè)循環(huán)輸出的宏 --> <#macro list title items> ${title}<#list items as x>*${x}</#list> </#macro> <#-- 使用宏 --> <@list items=["mouse", "elephant", "python"] title="Animals"/> // 輸出Animals *mouse *elephant *python 結(jié)束macro指令 // return指令用于結(jié)束macro指令 <#-- 創(chuàng)建宏 --> <#macro book>spring<#return>j2ee </#macro><#-- 使用宏 --> <@book /> // 上面的代碼輸出:spring,而j2ee位于return指令之后,不會(huì)輸出.

?

轉(zhuǎn)載于:https://www.cnblogs.com/i-tao/p/9292921.html

總結(jié)

以上是生活随笔為你收集整理的Freemaker FTL指令常用标签及语法的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。