FreeMark内置函数使用说明

xiangxingchina

浏览: 527074 次
性别:
来自: 北京

最近访客更多访客>>

WoKo_Jb

lanmubai

forfelicity

linktoyl22

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

freemarker 算法 F#J#

在我们应用Freemarker过程中，经常会操作例如字符串，数字，集合等，却不清楚Freemrker有没有类似于Java一样有相关的类及方法。在本文当中，我将向大家详细的介绍Freemarke的内置函数及用法，以便能帮助大家更熟练的应用Freemarker完成项目开发。

一、Sequence的内置函数

1.sequence?first 返回sequence的第一个值。

2.sequence?last 返回sequence的最后一个值。

3.sequence?reverse 将sequence的现有顺序反转，即倒序排序

4.sequence?size 返回sequence的大小

5.sequence?sort 将sequence中的对象转化为字符串后顺序排序

6.sequence?sort_by(value) 按sequence中对象的属性value进行排序

注意：Sequence不能为null

二、Hash的内置函数

1.hash?keys 返回hash里的所有key,返回结果为sequence

2.hash?values 返回hash里的所有value,返回结果为sequence

三、操作字符串函数

1.substring（start,end）从一个字符串中截取子串

start:截取子串开始的索引，start必须大于等于0，小于等于end

end: 截取子串的长度，end必须大于等于0，小于等于字符串长度，如果省略该参数，默认为字符串长度。

2.cap_first 将字符串中的第一个单词的首字母变为大写。

3.uncap_first将字符串中的第一个单词的首字母变为小写。

4.capitalize将字符串中的所有单词的首字母变为大写

5.date,time，datetime将字符串转换为日期

注意：如果指定的字符串格式不正确将引发错误

6.ends_with 判断某个字符串是否由某个子串结尾，返回布尔值

注意：布尔值必须转换为字符串才能输出

7.html 用于将字符串中的<、>、&和"替换为对应得<>&quot:&amp

8.index_of（substring,start）在字符串中查找某个子串，返回找到子串的第一个字符的索引，如果没有找到子串，则返回-1。

Start参数用于指定从字符串的那个索引处开始搜索，start为数字值。

如果start大于字符串长度，则start取值等于字符串长度，如果start小于0，则start取值为0。

9.length返回字符串的长度

10.lower_case将字符串转为小写

11.upper_case将字符串转为大写

12.contains 判断字符中是否包含某个子串。返回布尔值

注意：布尔值必须转换为字符串才能输出

13.number将字符串转换为数字

14.replace用于将字符串中的一部分从左到右替换为另外的字符串。

15.split使用指定的分隔符将一个字符串拆分为一组字符串

16.trim 删除字符串首尾空格

四、操作数字

1.c 用于将数字转换为字符串

2.string用于将数字转换为字符串

Freemarker中预订义了三种数字格式：number,currency（货币）和percent(百分比)其中number为默认的数字格式转换

五操作布尔值

string 用于将布尔值转换为字符串输出

true转为"true"，false转换为"false"

foo?string("yes","no")如果布尔值是true,那么返回"yes",否则返回no

-------------------------------------------------------------------------------------------------------------------------------------------------

判断是否为空:

1.<#if xx?exists>

2.<#if xx??>

3.<#if xx?default('xxx')>

不然当xxList没有数据的时候，很大很大一个黄页就等着你了

数据类型转换：

${xx?string} //字符串
${xx?number}//整数
${xx?currency}//小数
${xx?percent} //百分比

截取字符串长度：

有的时候我们在页面中不需要显示那么长的字符串，比如新闻标题，这样用下面的列子就可以自定义显示的长度

<#if news.title?length lt 13 >
${news.title}

<#else>
${news.title[0..12]}
</#if>

item_index:是list当前值的下标
item_has_next:判断list是否还有值

<#list seq as x>
${x_index + 1 }. ${x}<#if x_has_next>,</#if>
</#list>

分享一个用freemarker标签实现一行五列的表格算法

< table cellspacing ="0" cellpadding ="0" border ="0" class ="listTable" >
< #list tagPage.result as tag >
< #-- 取5的模，即除于5的倍数余数为0的生成行的开头<tr > -->
< #if tag_index%5 ==0 >< tr ></ #if >
< td >
  < a href ="post_bytag.action?tagId=${tag.id}" > ${tag.name} </ a > (${tag.counts})  
</ td >
< #-- 如果最后一个不是刚好5列，则要补充完剩下的列 -- >
< #if tag_index == (tagPage.result?size-1) && tag_index%5! =4 >
< #assign end =(tagPage.result?size-tag_index+1) />
< #-- 根据缺少的列数重新定义一个list生成列 -- >
< #list 0..end as x >
< td >   </ td >
</ #list >
</ tr >
</ #if >
< #-- 取5的模，即除于5的倍数余数为4（0到4刚好5列）的生成行的结尾</tr > -->
< #if tag_index%5 ==4 ></ tr ></ #if >
</ #list >
</ table >

<#assign n = 0 />
<#list categories as category>
   <#list category.getForums() as forum>
     <#assign n = n+1 />
     <#if n gt 5><#break></#if>//取前五条记录
     <a href="${JForumContext.encodeURL("/forums/show/${forum.id}")}">${forum.name?html}</a>  
   </#list>
   <#if n gt 5>//在五条记录后面加上一条更多的标签
    <span onclick="showMoreTags('forumNameMoreTags',event,-250,135);"><a href="#this" >${I18n.getMessage("ForumIndex.forumNameTagsMore")}</a></span>
    <#break>
   </#if>
</#list>
</div>

--------------------------------------------------------------------------------------------------------------------------

用途：某些比较BT 的排版需求

模板:

<#assign seq = ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j']>
<#list seq?chunk(4) as row>
<ul>
<li><#list row as cell>${cell} </#list></li>
</ul>
</#list>

<#list seq?chunk(4, '-') as row>
<tr>
<td><#list row as cell>${cell} </#list></td>
</tr>
</#list>

分享到：