# 1\. 文章列表 xy:arclist
{xy:arclist \[屬性=值 屬性=值\]}\[field.\*/\]{/xy:arclist}
1、自定義標簽使用\[cfield:\*/\]
2、鏈接中自帶域名\[field.link/\]
適用范圍：適用于文章列表頁，支持自定義模型字段
**標簽格式**
```
{xy:arclist}
[field:*/]
{/xy:arclist}
```
**嵌套使用**
```
{xy:channel type=nav ref=one}
[field.typetitle/] <br>
{xy:channel ref=two refs=one}
[field.typetitle/] <br>
{xy:channel ref=th refs=two}
[field.typetitle/] <br>
{xy:arclist refs=th}
[field.title/]<br>
{/xy:arclist}
{/xy:channel}
{/xy:channel}
{/xy:channel}
```
通過refs引用標簽節點名稱來進行動態顯示文章列表，以上演示動態獲取三級欄目且顯示三級欄目對應的文章列表
> 標簽屬性
>
| 名稱 | 類型 | 必須 | 示列值 | 默認值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| typeid | 整型 | 是 | \>0 | 無 | 欄目ID,在列表模板和檔案模板中一般不需要指定 |
| size | 整型 | 否 | \>0 | 20 | 返回文檔列表總數,默認為20條全部返回，也可以配合分頁使用 |
| titlelen | 整型 | 否 | \>0 | 40 | 標題長度,等同于titlelength默認40個漢字 |
| flag | 字符串 | 否 | c,f,h,p | 無 | 指定顯示某個屬性的文章數據，幻燈f，圖片p，推薦c，頭條h，跳轉 j；請按照示例值順序設置，例如：flag=c,f;c,p |
| noflag | 字符串 | 否 | c,f,h,p | 無 | noflag=c，顯示文章屬性除c之外的所有文章;請按照示例值順序設置，例如：noflag=c,f;c,p |
| orderby | 字符串 | 否 | date | 無 | 根據時間排序:date，根據文章等級排序:sort，根據文章點擊數排序:hit(如果點擊量增加了，需要重新生成排序才會變化)，不填則顯示默認順序 |
| order | 字符串 | 否 | asc | desc | desc:按照倒序排列，asc:按照正序排列 |
| ispaging | 布爾型 | 否 | true | false | 當文章列表出現分頁標簽時必須添加本屬性 |
可包含字段\[field.\*/\]
| 字段名稱 | 描述 |
| --- | --- |
| \[field.index/\] | 序號，根據顯示條數顯示的序號1 2 …..10 |
| \[field.id/\] | 文章id，對應文章在數據庫里的自增長編號 |
| \[field.title/\] | 文章標題，標題長度根據titlelen的屬性值指定，默認40個漢字 |
| \[field.fulltitle/\] | 完整文章標題，（顯示完整的標題） |
| \[field.author/\] | 文章作者 |
| \[field.source/\] | 文章來源 |
| \[field.content/\] | 文章內容，獲取文章全部內容 |
| \[field.typename/\] | 文章所屬分類的名稱 |
| \[field.typeid/\] | 文章所屬分類的編號 |
| \[field.typelink/\] | 文章分類鏈接，點擊連接連接到當前分類的列表：\[field.typelink/\] |
| \[field.typetitle/\] | 文章分類標題|
| \[field.litpic/\] | 文章縮略圖，上傳文章的縮略圖，調用縮略圖地址：\[field.litpic/\] |
| \[field.link/\] | 文章內容鏈接，點擊顯示文章具體的內容地址,一般配合文章標題使用：\[field.typelink/\] |
| \[field.num/\] | 當前頁面文章數量 |
| \[field.date fmt=yyyy-MM-dd/\] | 根據用戶指定的格式輸出時間，\[field.date fmt=yyyy-MM-dd/\] |
| \[field.descrip/\] | 文章摘要 |
| \[field.hit/\] | 文章點擊量 |
| \[field.flag/\] | 文章flag屬性 |
| \[field.keyword/\] | 文章關鍵字 |
文章列表標簽完整實例
```
{xy:arclist flag=c flag=f size=5 titlelen=45 typeid=2734}
<li>
<a href='{xy:global.url/}[field.link/]' target="_self">[field.title/]</a>
<img src="{xy:global.url/}[field.litpic/]"/>
</li>
{/xy:arclist}
```
