编辑“ZCMS/循环标签”

{{ZCMS导航}}
<cms:list>循环[[标签]]用于显示文章、图片、栏目、[[友情链接]]等列表，循环体中通过调用 item的属性来获取文章、图片、栏目、友情链接的属性值，可以灵活的控制循环的表现形式。 

如显示文章列表： 
<pre>
<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> 
</pre>

'''<cms:list>的主要属性如下'''： 
{|border="1" align="center" width="75%"
|-
!属性|| 允许的值|| 说明
|-
| rowspan="7" | item
| article
| 文章
|-
| catalog
| 栏目
|-
| image
| 图片
|-
| video
| 视频
|-
| audio
| 音频
|-
| attachment
| 附件
|-
| friendlink
| 友情链接
|-
| count
| 1~n
| 整数，列表显示数目
|-
| page
| ture/false
| 是否分页
|-
| pagesize
| 1~n
| 整数，分页时每页显示条数
|-
| name
| 
| 栏目名称，显示指定名称的栏目的列表
|-
| Id
| 
| 栏目 id，显示指定 id 的栏目的列表
|-
| rowspan="3" | type
| relate
| 配合文章(item=”article”)使用，相关文章
|-
| hot
| 配合文章使用，最热文章
|-
| recent
| 配合文章使用，最新文章
|}

'''常见用法 '''
*'''文章分页列表 '''
代码示例：
<pre> 
<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> 
</pre> 

'''注意：'''其中${PageBar}为默认分页效果，如果需要定制分页条，请参考 [[ZCMS/文档对象|Page 对象]]进行分页定制。

模板生成文件如图所示：
[[Image:ZCMS_CTag1.png|center]]

*'''文章列表（最新、最热、相关文章）''' 
示例： 
<pre>
  <cms:list item="Article" type="Hot/Recent/Relate" count="10" name="国际新闻"> 
    <li><a href="${Article.Link}" target="_blank">${Article.Title}</a></li> 
  </cms> 
</pre>

效果如图： 
[[Image:ZCMS_CTag2.png|center]] 
 
*'''栏目列表 '''
示例：
<pre> 
<cms:list item="Catalog"  type="article" level="Current" count="5"> 
 <a href="${Catalog.Link}" target="_blank">${Catalog.Name}</a><br/> 
</cms:list> 
</pre> 

显示效果： 
[[Image:ZCMS_CTag3.png|center]] 

*'''图片列表''' 
示例： 
<pre>
<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> 
</pre>

显示效果
[[Image:ZCMS_CTag4.png|center]] 

*'''视频列表 '''
示例： 
<pre>
<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> 
</pre>

*'''友情链接 '''
示例： 
<pre>
<h2>友情链接</h2> 
<ul> 
  <cms:list item="FriendLink" name="政府友情链接" count=10> 
    <li><a href="${FriendLink.URL}" 
target="_blank">${FriendLink.Name}</a></li> 
  </cms:list> 
</ul> 
</pre>

显示效果： 
[[Image:ZCMS_CTag5.png|center]] 




==参考来源==
*http://www.zving.com/wdzx/zcms/index.shtml

[[category:ZCMS|X]]

{{ZCMS使用手册}}