## 列表標簽
>[success] 例如數據庫中有以下表:( easy\_ 為自定義的表前綴 )
```
easy_cms_article
easy_cms_product
easy_cms_......
```
\-
>[danger] **不支持查詢以下表名**
```
easy_article
easy_product
easy_...
```
提示:`easywcms` 是一個多插件的系統,為了更好的辨別cms系統的表名,所以表名都是以 `_cms_` 這樣的結構
\-
## 標簽基本使用方法
這里以查詢 `easy_cms_article` 表為例
```
{cms:list model='article'}
<a href="{$r.url}">{$r.title}</a>
{/cms:list}
```
\-
## 屬性說明
```
model:查詢的表名 例如:article 那么將會查詢數據庫中的 easy_cms_article 表
field:指定查詢的字段 默認:'*'
where:指定查詢條件(必須以字符串型式):'posid=1 and headid=2' ,默認:空
order: 排序方式 默認:'listorder desc,id desc'
limit:限制結果數量,例:'10' 或 '10,25'
catid:指定欄目ID查詢,系統會自動查詢該ID下的所有子欄目的數據
id : 定義數據查詢的結果存放變量 默認:'r'
key :返回數據主鍵變量名稱 默認:'i'
mod : 以數據主鍵 key='i' 求余,默認: '2' 。 ( 當 $mod 為零時,你可以做一些其他的處理,具體請看舉例 )
posid:指定查詢推薦的數據,參可選1,2,3,4,5 默認為空
headid:指定查詢頭條的數據,參可選1,2,3,4,5 默認為空
```
-
## 舉例
需求說明:查詢`easy_cms_article`表的`id,title,url`字段并且只查詢欄目`id=2`下的數據
**輸出效果:**
```
<ul>
<li><a href="">這是標題1</a></li>
<li><a href="">這是標題2</a></li>
<li><a href="">這是標題3</a></li>
</ul>
<ul>
<li><a href="">這是標題4</a></li>
<li><a href="">這是標題5</a></li>
<li><a href="">這是標題6</a></li>
</ul>
...
```
**實現代碼:**
```
<ul>
{cms:list model='article' field='id,title,url' catid='2' mod='3' }
<li><a href="{$r.url}">{$r.title}</a></li>
{if ($mod==0)}</ul><ul>{/if}
{/cms:list}
</ul>
...
```