dede模板标签手册：[1]arclist|文档列表

1、获取指定频道文档

频道也就是模型，参数为channelid

{dede:arclist  channelid='1'}

    <li>[[field:typelink/]]<a href="[field:arcurl/]">[field:title/]</a>日期:[field:pubdate function="GetDateTimeMK(@me)"/]</li>

{/dede:arclist} 

2、获取指定栏目文档

要获取指定栏目的文， 就比必需在arclist标签里加上typeid，多个栏目可以用英文点号格开,如typeid="1,3,4"

{dede:arclist  typeid='1'}

    <li>[[field:typelink/]]<a href="[field:arcurl/]">[field:title/]</a>日期:[field:pubdate function="GetDateTimeMK(@me)"/]</li>

{/dede:arclist} 

3、获取指定数量文档

limit='起始id,起始数量'。用获取指定数量或者某个id范围内的文章，

比如我们要获取一条记录： 

{dede:arclist   row='3'}

    <li>[[field:typelink/]]<a href="[field:arcurl/]">[field:title/]</a>日期:[field:pubdate function="GetDateTimeMK(@me)"/]</li>

{/dede:arclist} 

获取指定范围的记录：

{dede:arclist  type='1' limit='2，4'}

    <li>[[field:typelink/]]<a href="[field:arcurl/]">[field:title/]</a>日期:[field:pubdate function="GetDateTimeMK(@me)"/]</li>

{/dede:arclist} 

4、获取指定属性的文档

我们发布文章时，有个文章属性，我们可以根据这个属性，调取指定文章

自定义属性分别是：头条[h]推荐[c]图片[p]幻灯[f]滚动[s]跳转[j]图文[a]加粗[b]

{dede:arclist  flag='c' }

    <li>[[field:typelink/]]<a href="[field:arcurl/]">[field:title/]</a>日期:[field:pubdate function="GetDateTimeMK(@me)"/]</li>

    {/dede:arclist} 

多个属性，用英文点号格开：flag='h,c,p,f,s';

有flag参数，也有个noflag参数，noflag作用刚好和flag相反，用来排除具有相关属性的文章，如要获取除头条以外的所有文章，可以加上noflag='h'参数。

还有一个type参数和flag类似，但是官方参考手册却写成了listtype。

type="all",全部文档，image含有缩略图文档，commend推荐文档

{dede:arclist type="commend"}

    <li>[[field:typelink/]]<a href="[field:arcurl/]">[field:title/]</a>日期:[field:pubdate function="GetDateTimeMK(@me)"/]</li>

 {/dede:arclist} 

也可以这样写:

{dede:coolart type="commend"}

    <li>[[field:typelink/]]<a href="[field:arcurl/]">[field:title/]</a>日期:[field:pubdate function="GetDateTimeMK(@me)"/]</li>

 {/dede:coolart} 

而调用含有缩略图的文档可以使用imglist模板

{dede:imglist type="commend"}

    <li>[[field:typelink/]]<a href="[field:arcurl/]">[field:title/]</a>日期:[field:pubdate function="GetDateTimeMK(@me)"/]</li>

 {/dede:imglist} 

5、获取指定天数的文档

subday参数值是天数，按发布时间调取文档，更改文章的更新时间不影响调用。

比如，你在11月4号发布了三篇文章，但文章的更新时间分别为11月2号，11月3号，11月4号，subday的值为1时(即获取1天内发布的文档)，依然会调取这三篇文档。

{dede:arclist  subday='1' }

    <li>[[field:typelink/]]<a href="[field:arcurl/]">[field:title/]</a>日期:[field:pubdate function="GetDateTimeMK(@me)"/]</li>

    {/dede:arclist} 

6、获取指定文档

idlist参数的值为文档的id，多个文档可用点号格开.

{dede:arclist idlist="3,5"}

    <li>[[field:typelink/]]<a href="[field:arcurl/]">[field:title/]</a>日期:[field:pubdate function="GetDateTimeMK(@me)"/]</li>

    {/dede:arclist} 

7、获取含有指定关键字的文档

{dede:arclist keyword="监狱,维基"}

    <li>[[field:typelink/]]<a href="[field:arcurl/]">[field:title/]</a>日期:[field:pubdate function="GetDateTimeMK(@me)"/]</li>

    {/dede:arclist} 

8、设置文档排序方式

arclist的排序是通过两个参数来实现的，一个指定排序字段，一个指定排序主式为倒序还是降序

orderby="排序字段",orderway="DESC",orderway的默认值为DESC;当无orderway参数时，文档按倒序排列。

{dede:arclist orderby="senddate" orderway='ASC'}

    <li>[[field:typelink/]]<a href="[field:arcurl/]">[field:title/]</a>日期:[field:pubdate function="GetDateTimeMK(@me)"/]</li>

    {/dede:arclist} 

9、设置标题和摘要长度

{dede:arclist titlelen='14' infolen='20'}

    <li> 

     [<b>[field:typelink/]</b>] <a href="[field:arcurl/]" class="title">[field:title/]</a> <span class="info"> <small>日期：</small>[field:pubdate function="GetDateTimeMK(@me)"/] <small>点击：</small>[field:click/] <small>好评：</small>[field:scores/] </span>

     <p class="intro"> [field:infos/]...

    </li>

    {/dede:arclist} 

</ul>

10、其他参数用法

对innertext来说，只当标签内无任何代码时，innerText才会起作用

{dede:arclist titlelen='14' innertext=' <a href="[field:arcurl/]" class="title">[field:title/]</a> '}这里必需没有任何代码 {/dede:arclist} 

如何我们直接写成{dede:arclist} {/dede:arclist} ，dedecms将会调用模板目录的system目录下的part_arclist.htm文件里的样式

imgwidth和imgheight必需配合[field:image/]和[field:imglink/]字段标签使用，才有效果。

11、组合调用

{dede:arclist titlelen='14' infolen='20' keyword="小米" typeid="4" orderby="pubdate" orderway="ASC" flag="p"}

    <li> [field:array runphp='yes']@me = (empty(@me['litpic']) ? "" : "<a href='{@me['arcurl']}' class='preview'><img src='{@me['litpic']}'/></a>"); [/field:array]

     [<b>[field:typelink/]</b>] <a href="[field:arcurl/]" class="title">[field:title/]</a> <span class="info"> <small>日期：</small>[field:pubdate function="GetDateTimeMK(@me)"/] <small>点击：</small>[field:click/] <small>好评：</small>[field:scores/] </span>

     <p class="intro"> [field:description/]...

    </li>

    {/dede:arclist} 

12、底层模板字段

ID(同id),typeid,sortrank,flag,ismake,channel,arcrank,click,money,title,shorttitle,color,writer,source,litpic(同picname),pubdate,senddate,mid, lastpost,scores,goodpost,badpost,notpost,description(同infos,info,但infolen不会影响其长度),filename, image, imglink, fulltitle, textlink, typelink,plusurl, memberurl, templeturl,stime(pubdate 的"0000-00-00"格式)

其中：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' alt=’titile’>