ZCMS/循环标签
来自站长百科
<cms:list>循环标签用于显示文章、图片、栏目、友情链接等列表,循环体中通过调用 item的属性来获取文章、图片、栏目、友情链接的属性值,可以灵活的控制循环的表现形式。
如显示文章列表:
<ul> <cms:list item="Article" type="Recent" count="20" name="国际要闻"> <li><a href="${Article.Link}" target="_blank">${Article.Title}</a> ${Article.PublishDate|Format=yyyy-MM-dd}</li> </cms:list> </ul>
<cms:list>的主要属性如下:
属性 | 允许的值 | 说明 |
---|---|---|
item | article | 文章 |
catalog | 栏目 | |
image | 图片 | |
video | 视频 | |
audio | 音频 | |
attachment | 附件 | |
friendlink | 友情链接 | |
count | 1~n | 整数,列表显示数目 |
page | ture/false | 是否分页 |
pagesize | 1~n | 整数,分页时每页显示条数 |
name | 栏目名称,显示指定名称的栏目的列表 | |
Id | 栏目 id,显示指定 id 的栏目的列表 | |
type | relate | 配合文章(item=”article”)使用,相关文章 |
hot | 配合文章使用,最热文章 | |
recent | 配合文章使用,最新文章 |
常见用法
- 文章分页列表
代码示例:
<ul> <cms:list item="Article" type="Recent" pagesize="30" page="true"> <li><a href="${Article.Link}" target="_blank">${Article.Title|CharWidth=35}</a> <span>${Article.PublishDate|Format=yyyy-MM-dd}</span></li> </cms:list> </ul> <div>${pagebar}</div>
注意:其中${PageBar}为默认分页效果,如果需要定制分页条,请参考 Page 对象进行分页定制。
模板生成文件如图所示:
- 文章列表(最新、最热、相关文章)
示例:
<cms:list item="Article" type="Hot/Recent/Relate" count="10" name="国际新闻"> <li><a href="${Article.Link}" target="_blank">${Article.Title}</a></li> </cms>
效果如图:
- 栏目列表
示例:
<cms:list item="Catalog" type="article" level="Current" count="5"> <a href="${Catalog.Link}" target="_blank">${Catalog.Name}</a><br/> </cms:list>
显示效果:
- 图片列表
示例:
<table cellspace="1" border="0"> <tr> <cms:list item="Image" count="20" name="车身外观"> <td><a href="${Image.link}" target="_blank"><img src="${level}${Image.Path}s_${Image.FileName}" alt="${Image.Name}" ${Image.Name}</a></td> <% if(i%2==2-1){write("</tr></tr>");}%> </cms:list> </tr> </table>
显示效果
- 视频列表
示例:
<table cellspace="1" border="0"> <tr> <cms:list item="Video" count="20" name="最新活动"> <td><a href="${Video.Link}" target="_blank"><img src="${Level}${Video.Path}${Video.ImageName}" alt="${Video.Name}"/><br ${Video.Name}</a></td> <% if(i%2==2-1){write("</tr><tr>");} %> </cms:list> </tr> </table>
- 友情链接
示例:
<h2>友情链接</h2> <ul> <cms:list item="FriendLink" name="政府友情链接" count=10> <li><a href="${FriendLink.URL}" target="_blank">${FriendLink.Name}</a></li> </cms:list> </ul>
显示效果:
参考来源[ ]
ZCMS使用手册导航 | ||||||
---|---|---|---|---|---|---|
|