概述

功能说明

适用范围

基本语法

属性说明

底层模板字段

字段调用方法

概述

这个标记是织梦(DedeCms)最常用的一个标记，也叫自由列表标记，其中 hotart、coolart、likeart、artlist、imglist、imginfolist、specart、autolist 这些标记都是由这个标记所定义的不同属性延伸出来的别名标记。

功能说明

获取指定的文档列表

适用范围

封面模板、列表模板、文档模板

基本语法

{dede:arclist typeid='' row='' col='' titlelen='' infolen=''

imgwidth='' imgheight='' listtype='' orderby='' keyword=''}

底层模板(InnerText)

{/dede:arclist}

属性说明

[1] typeid='' 表示栏目ID，在列表模板和档案模板中一般不需要指定，在封面模板中允许用","分开表示多个栏目；

[2] row='' 表示返回文档列表总数；

[3] col='' 表示分多少列显示（默认为单列）；

[4] titlelen='' 表示标题长度；

[5] infolen='' 表示内容简介长度；

[6] imgwidth='' 表示缩略图宽度；

[7] imgheight='' 表示缩略图高度；

[8] type='' 表示档案类型，其中空值、不使用这个属性或type='all'时为普通文档

§ type='commend'时，表示推荐文档，等同于 {dede:coolart}{/dede:coolart}

§ type='image'时，表示必须含有缩略图片的文档，等同于{dede:imglist}{/dede:imglist}、{dede:imginfolist}{/dede:imginfolist}

§ type='spec'时，表示专题，等同于标记{dede:specart}{/dede:specart}

以上属性值可以联合使用，如： type='commend image' 表示推荐的图片文档

[9] orderby='' 表示排序方式，默认值是 senddate 按发布时间排列。

§ orderby='hot' 或 orderby='click' 表示按点击数排列

§ orderby='pubdate' 按出版时间排列（即是前台允许更改的时间值）

§ orderby='sortrank' 按文章的新排序级别排序（如果你想使用置顶文章则使用这个属性）

§ orderby='id' 按文章ID排序

§ orderby='postnum' 按文章评论次数排序

§ orderby='rand' 随机获得指定条件的文档列表

[10] orderway='' 值为 desc 或 asc ，指定排序方式是降序还是顺向排序，默认为降序。

[11] keyword='' 表示含有指定关键字的文档列表，多个关键字用","分开

[12] channelid='' 表示特定的频道模型ID，内置的频道：专题(-1)、文章(1)、图集(2)、Flash(4)、软件(3)

[13] limit='起始,结束' 表示限定的记录范围，row属性必须等于"结束 - 起始"，mysql的limit语句是由0起始的，如 “limit 0,5”表示的是取前五笔记录，“limit 5,5”表示由第五笔记录起，取下五笔记录，使用了本属性后，row属性将无效。

[14] att='数值' 表示自定义属性值

[15] subday='天数' 表示在多少天以内的文档，通常用于获取指定天数的热门文档、推荐文档、热门评论文档等

[16] partsort='排列位数'表示自动获得父栏目的所有子数中排列在第几位的栏目ID，标记为 {dede:autolist}{/dede:autolist} 时，使用本属性才有效。

底层模板字段

ID(同 id),title,iscommend,color,typeid,ismake,description(同 info),writer,shorttitle,memberid

pubdate,senddate,arcrank,click,litpic(同 picname),typedir,typename,

arcurl(同 filename),typeurl,stime(pubdate 的"0000-00-00"格式),

textlink,typelink,imglink,image

其中：

textlink = <a href='arcurl'>title</a>

typelink = <a href='typeurl'>typename</a>

imglink = <a href='arcurl'><img src='picname' border='0' width='imgwidth' height='imgheight'></a>

image = <img src='picname' border='0' width='imgwidth' height='imgheight'>

字段调用方法

[field:varname/]

如：

{dede:arclist infolen='100'}

[field:textlink/]

<br>

[field:info/]

<br>

{/dede:arclist}

注：底层模板里的Field实现也是织梦标记的一种形式，因此支持使用PHP语法，Function扩展等功能

如： 给当天发布的内容加上 (new) 标志

[field:senddate runphp='yes']

$ntime = time();

$oneday = 3600 * 24;

if(($ntime - @me)<$oneday) @me = "<font color='red'>(new)</font>";

else @me = "";

[/field:senddate