## 列表标签
>[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>
...
```