在织梦CMS(DedeCMS)中,arclist
标签是一个功能强大且灵活的标签,用于获取指定的文档列表并展示在前端,以下是对arclist
标签的详细图文介绍:
基本语法
{dede:arclist flag='h' typeid='' row='' col='' titlelen='' infolen='' imgwidth='' imgheight='' listtype='' orderby='' keyword='' limit='0,1'} <a href='[field:arcurl/]'>[field:title/]</a> {/dede:arclist}
主要属性及功能说明
参数名 | 说明 |
flag | 自定义属性值,如头条[h]、推荐[c]、图片[p]、幻灯[f]、滚动[s]、跳转[j]、图文[a]、加粗[b]。 |
typeid | 栏目ID,在列表模板和档案模板中一般不需要指定,在首页模板中允许用逗号分开表示多个栏目。 |
row | 返回文档列表总数。 |
col | 分多少列显示,默认为单列;当col大于1时,可以通过div+css实现多列显示。 |
titlelen | 标题长度。 |
infolen | 内容简介长度。 |
imgwidth | 缩略图宽度。 |
imgheight | 缩略图高度。 |
listtype | 栏目类型,如含有缩略图、幻灯等。 |
orderby | 文档排序方式,如按点击数、出版时间、ID等排序。 |
keyword | 含有指定关键字的文档列表,多个关键字用逗号分隔。 |
limit | 限定的记录范围,如limit=’1,2’表示从ID为1的记录开始,取2条记录。 |
orderway | 指定排序方式是降序还是顺向排序,默认为降序。 |
subday | 表示在多少天以内的文档。 |
使用实例
调用推荐文章
{dede:arclist flag="c" channelid='' row='10' titlelen='60' orderby=''} <li><a href='[field:arcurl /]' title="[field:fulltitle /]">[field:title /]</a></li> {/dede:arclist}
解释:调用10条推荐文章,标题长度为30个汉字,默认按发布时间排序。
调用最新文章按发布时间排序
{dede:arclist channelid='' row='10' titlelen='60'} <li><a href='[field:arcurl /]' title="[field:fulltitle /]">[field:title /]</a></li> {/dede:arclist}
解释:调用10条最新文章,按发布时间排序,标题长度为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}
解释:调用10条文章,按ID降序排列,标题长度为30个汉字。
按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}
解释:调用10条文章,按ID升序排列,标题长度为30个汉字。
调用含有缩图的文档
{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}
解释:调用10条含有缩图的文章,标题长度为30个汉字。
日期的各种格式示例
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/> 09年06月08日 [field:pubdate function=strftime('%y年%m月%d日',@me)/]<br/> 2009年06月08日 14点30分 [field:pubdate function=strftime('%Y年%m月%d日 %H:%M',@me)/]<br/>
通过这些实例,可以更好地控制内容展示的日期格式。
相关FAQs
1、如何在首页调用多个栏目的最新文章?
答:可以在首页模板中使用如下代码:
“`html
{dede:arclist typeid=’1,2,3′ row=’10’ titlelen=’60’}
<li><a href='[field:arcurl /]’ title=”[field:fulltitle /]”>[field:title /]</a></li>
{/dede:arclist}
“`
typeid='1,2,3'
表示调用ID为1、2、3的栏目的最新文章。
2、如何调用特定ID的文章?
答:可以使用idlist
参数来调用特定ID的文章。
“`html
{dede:arclist idlist=’4,45,78,237′ row=’10’ titlelen=’60’}
<li><a href='[field:arcurl /]’ title=”[field:fulltitle /]”>[field:title /]</a></li>
{/dede:arclist}
“`
这段代码将调用ID为4、45、78、237的文章。