一、语法
{list action=page ....}{/list}
简写(3.2.19以上版本支持):{page ....}{/page }
二、参数介绍(红色表示必填参数,蓝色表示系统默认参数)
| 参数 | 介绍 |
|---|---|
| action | page |
| site | 站点id,默认当前站点,填写其他站点id |
| id | 指定显示,多个id以小写分号分开,例如1,2,3,4,5 |
| show | 有show参数表示显示隐藏单页(无论show=几都有效) |
| num | 显示数量,默认显示全部 |
| pid | 上级单页,pid=0表示顶级单页数据 |
| return | 默认返回变量为t,调用方式就是{$t.字段值}(多级list查询必须设置return=其他字母,否则你懂得) |
三、返回变量
| 变量 | 参数 |
|---|---|
| {$error} | 当查询不到数据时,会返回错误信息,调试模板时很有用哦(写在list标签以外) |
| {$count} | 当前查询的记录,当存在分页时,表示当前页的记录数(写在list标签以外) |
| {$key} | 当前记录指针位置,从0开始(写在list标签以内) |
| 当存在return=字母时,以上变量都要写成这种格式{$变量_字母},例如{list ...reutrn=a}时,变量格式{$key_a} | |
| {$is_first} | 判断是否第一条,{if $is_first}第一条{/if} |
| {$is_last} | 判断是否最后一条,{if $is_last}最后一条{/if} |
四、显示字段
{$t.字段名称}或者{$t['字段名称']}
五、相关例子
调用首页的顶级自定义页面
{list action=page pid=0}
自定义页面名称:{$t.name}
自定义页面标题:{$t.title}
自定义页面内容:{$t.content}
自定义页面地址:{$t.url}
{/list}
当存在子页面时,显示其子页面
{if $child}
<!--child为真时表示存在子类,那么我们就调用它的子类-->
{list action=page pid=$id}
<a href="{$t.url}">{$t.name}</a>
{/list}{$error}
{else}
<!--否则就调用它的同级类-->
{list action=page pid=$pid}
<a href="{$t.url}">{$t.name}</a>
{/list}{$error}
{/if}以上代码仅在自定义页面模板中有效
文档最后更新时间:2018-09-29 07:36:29