在织梦CMS(DedeCMS)中,{dede:arclist}
标签是常用的标记之一,用于获取指定文档列表,该标签也称为自由列表标记,其别名包括imglist、imginfolist、specart、coolart和autolist,以下是对{dede:arclist}
的详解:
基本语法
{dede:arclist flag='' typeid='' row='' col='' titlelen='' infolen='' imgwidth='' imgheight='' listtype='' orderby='' keyword='' limit='0,1'}
<a href='[field:arcurl/]'>[field:title/]</a>
{/dede:arclist}
常用属性
属性名 | 说明 |
typeid | 栏目ID,在列表模板和档案模板中一般不需要指定,首页模板中可用逗号分隔表示多个栏目 |
row | 调用记录数 |
titlelen | 标题长度(汉字个数) |
infolen | 摘要长度(汉字个数) |
imgwidth | 缩略图宽度(像素) |
imgheight | 缩略图高度(像素) |
listtype | 列表样式(如图片列表、幻灯等) |
orderby | 排序方式(如按点击量、发布时间等) |
keyword | 含有指定关键字的文档列表,多个关键字用逗号分隔 |
limit | 限定的记录范围,起始ID从0开始 |
idlist | 提取特定文档(文档ID),例子:idlist = ‘4,45,78,237’ |
orderway | 指定排序方式是降序还是顺向排序,默认为降序 |
使用实例
调用最新文章按发布时间排序
{dede:arclist channelid='' row='10' titlelen='60'}
<li><a href='[field:arcurl /]' title="[field:fulltitle /]">[field:title /]</a></li>
{/dede:arclist}
row='10'
:调用10条记录
titlelen='60'
长度为30汉字
默认按发布时间排序
按ID排序降序排列,从大到小
{dede:arclist channelid='' row='10' titlelen='60' orderby='id' }
<li><a href='[field:arcurl /]' title="[field:fulltitle /]">[field:title /]</a></li>
{/dede:arclist}
orderby='id'
:按ID降序排列
按ID排序顺序排列,从小到大
{dede:arclist channelid='' row='10' titlelen='60' orderby='id' orderway='asc' }
<li><a href='[field:arcurl /]' title="[field:fulltitle /]">[field:title /]</a></li>
{/dede:arclist}
orderway='asc'
:指定排序方式为升序
调用含有缩图的文档
{dede:arclist flag="p" row='10' titlelen='60'}
<li><a href="[field:arcurl /]"><img src="[field:litpic/]" border="0" alt="[field:fulltitle /]"></a><br/><span><a href="[field:arcurl /]" title="[field:fulltitle /]">[field:title /]</a></span></li>
{/dede:arclist}
flag="p"
:自定义属性值,表示图片列表
日期的各种格式展示
08 [field:pubdate function=strftime('%d',@me)/]<br/>
08 日 [field:pubdate function=strftime('%d日',@me)/]<br/>
0608 [field:pubdate function=strftime('%m%d',@me)/]<br/>
06月08日 [field:pubdate function=strftime('%m月%d日',@me)/]<br/>
090608 [field:pubdate function=strftime('%y%m%d',@me)/]<br/>
20090608 [field:pubdate function=strftime('%Y%m%d',@me)/]<br/>
09年06月08日 [field:pubdate function=strftime('%y年%m月%d日',@me)/]<br/>
2009年06月08日 [field:pubdate function=strftime('%Y年%m月%d日',@me)/]<br/>
FAQs
Q1:{dede:arclist}
标签的limit
属性如何使用?
A1:limit
属性用于指定记录的范围,格式为起始ID,记录数
。limit='1,2'
表示从ID为1的记录开始,取2条记录。
Q2: 如何调用含有缩图的文档?
A2: 使用flag="p"
属性可以调用含有缩图的文档,示例如下:
{dede:arclist flag="p" row='10' titlelen='60'}
<li><a href="[field:arcurl /]"><img src="[field:litpic/]" border="0" alt="[field:fulltitle /]"></a><br/><span><a href="[field:arcurl /]" title="[field:fulltitle /]">[field:title /]</a></span></li>
{/dede:arclist}