万能循环标签
名词解释
万能循环标签,可以读取数据库中任何表及关联表的数据,可以用在任何模板页面中,可以对数据进行分页操作。万能循环标签格式如下:
{cms:rs top="数量" field="字段1,字段2" table="表名" join="join参数" group="group参数" where="条件" order="排序" cache="缓存" cachetime="缓存时间" pagesize="分页数量" num="分页数字间隔数量" auto="i"}
{rs:eof}查不到数据时显示的内容{/rs:eof}
{$rs[字段]}
获取总数量:{$total_rs}
{/cms:rs}
说明:上面的标签中,所有的rs
字符,在一个循环中必须统一,如果有多层循环,每一层使用不同的字符。
详细参数说明:
参数 | 作用 | 是否必须 | 默认值 | 备注 |
---|
top | 显示的数量 | 否 | 10 | 为0时候,显示全部 |
pagesize | 分页数量 | 否 |
| 一个模板中,只能有一个pagesize参数 |
field | 查询的字段 | 否 | * | 默认查询所有字段 |
table | 表名 | 是 |
|
|
join | 链表 | 否 |
|
|
where | 查询的条件 | 否 | 1=1 |
|
order | 排序 | 否 | id desc |
|
group | 分组 | 否 |
|
|
cache | 是否缓存 | 否 | false | 如果为true,则系统缓存此查询数据 |
cachetime | 缓存时间 | 否 | 0 | 为0时,永久缓存,单位:分钟 |
num | 分页数字间隔数量 | 否 | 3 | 手机站中使用 |
key | 分页的自增字段Key | 否 | id | 分页中使用,如果表的自增字段不是ID,请自定义 |
auto | 循环中的自增变量 | 否 | i | 默认为i,如果有多层循环,请定义不同的变量 |
{cms:rs table="cms_content"}
{$rs[title]}
{/cms}