# **獲取文章列表 - arclist標簽**
[TOC]
## **屬性說明：**
- typeid='' 表示欄目ID，在列表模板和檔案模板中一般不需要指定，在封面模板中允許用`,`分開表示多個欄目；
- row='' 表示返回文檔列表總數；
- col='' 表示分多少列顯示（默認為單列）；
- titlelen='' 表示標題長度；
- infolen='' 表示內容簡介長度；
- imgwidth='' 表示縮略圖寬度；
- imgheight='' 表示縮略圖高度；
- 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' 表示推薦的圖片文檔
- orderby='' 表示排序方式，默認值是 senddate 按發布時間排列。
- orderby='hot' 或 orderby='click' 表示按點擊數排列
- orderby='pubdate' 按出版時間排列（即是前臺允許更改的時間值）
- orderby='sortrank' 按文章的新排序級別排序（如果你想使用置頂文章則使用這個屬性）
- orderby='id' 按文章ID排序
- orderby='postnum' 按文章評論次數排序
- orderby='rand' 隨機獲得指定條件的文檔列表
- orderway='' 值為 desc 或 asc ，指定排序方式是降序還是順向排序，默認為降序。
- keyword='' 表示含有指定關鍵字的文檔列表，多個關鍵字用","分開
- channelid='' 表示特定的頻道模型ID，內置的頻道：專題(-1)、文章(1)、圖集(2)、Flash(4)、軟件(3)
- limit='起始,結束' 表示限定的記錄范圍，row屬性必須等于"結束 - 起始"，mysql的limit語句是由0起始的，如 “limit 0,5”表示的是取前五筆記錄，“limit 5,5”表示由第五筆記錄起，取下五筆記錄，使用了本屬性后，row屬性將無效。
- att='數值' 表示自定義屬性值
- subday='天數' 表示在多少天以內的文檔，通常用于獲取指定天數的熱門文檔、推薦文檔、熱門評論文檔等
- 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]
```
