FreeMarker学习之List 列表指令 及 list, else, items, sep, break 指令

list指令

使用方法举例
假设 users 包含 ['Joe', 'Kate', 'Fred'] 序列:

<#list users as user>
  <p>${user}
</#list>

输出结果为:

  <p>Joe
  <p>Kate
  <p>Fred

关于下标(序号
使用 ${user_index} 即可获取每一项的下标,也就是序号。默认从零开始计算:0、1、2、3.....

特殊的循环变量
2.3.22和之前的版本中,有两个额外的循环变量可用:

  • item_index (已废弃,由 item?index 代替): 循环中当前项的索引(从0开始的数字)。
  • item_has_next (已废弃,由 item?has_next 代替): 辨别当前项是否是序列的最后一项的布尔值。
    举例
<#assign seq = {"winter","spring","sunmer","autumn"}>
<#list seq as x>
  ${x_index + 1}.${x}<#if x_has_next>,</#if>
<#list>

输出结果为:

1.winter,
2.spring,
3.summer,
4.autumn

else 指令

list 中的 else 仅从 FreeMarker 2.3.23 版本开始支持。

当没有迭代项时,才使用 else 指令:

<#list users as user>
  <p>${user}
<#else>
  <p>No users
</#list>

users 包含0项时,输出为:

<p>No users

items 指令

itemsFreeMarker 2.3.23 版本开始存在

当需要在第一列表项之前或在最后一个列表项之后打印一些东西,可以使用 items 指令,但列表项不能为空。
假设 users 包含 ['Joe', 'Kate', 'Fred'] 序列:

<#list users>
  <ul>
    <#items as user>
      <li>${user}</li>
    </#items>
  </ul>
</#list>

输出为:

<ul>
      <li>Joe</li>
      <li>Kate</li>
      <li>Fred</li>
</ul>

如果没有迭代项,那么上面的代码不会输出任何内容,即 <ul></ul> 也不会输出。

itemslist 指令也可以有 else 指令:

<#list users>
  <ul>
    <#items as user>
      <li>${user}</li>
    </#items>
  </ul>
<#else>
  <p>No users
</#list></pre>

更多细节:

  • list 可以有多个 items 指令, 但是只会执行一个,多个 items 可以放在不同的 if-else 分支中执行。

  • items 下不可以用上面说的 else 指令,但是 list 下可以有。

sep 指令

sepFreeMarker 2.3.23 版本开始存在。
sep 是编写 <#if item?has_next>...</#if> 的方便形式,有后续循环变量时执行。

当需要显示每两项之间的内容时,可以使用 sep。例如:
假设 users 包含 ['Joe', 'Kate', 'Fred'] 序列:

<#list users as user>${user}<#sep>, </#list>

输出结果为

Joe, Kate, Fred

上面的 <#sep>, </#list><#sep>, </#sep></#list> 的简写; 如果它在被包含的指令关闭的位置时,sep 结束标签可以忽略。下面的示例中,就不能使用该简写 (HTML标签不会结束任何代码,它们只是 FreeMarker 输出的原生文本):

<#list users as user>
  <div>
    ${user}<#sep>, </#sep>
  </div>
</#list>

break 指令

可以使用 break 指令在迭代的任意点退出。例如:

<#list 1..10 as x>
  ${x}
  <#if x == 3>
    <#break>
  </#if>
</#list>
  1
  2
  3
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,233评论 6 495
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,357评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,831评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,313评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,417评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,470评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,482评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,265评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,708评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,997评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,176评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,827评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,503评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,150评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,391评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,034评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,063评论 2 352

推荐阅读更多精彩内容