一、作用
用于表單的列表循環(huán)查詢
二、語(yǔ)法
{list action=form form=表單的id site=站點(diǎn)id ....}{/list}
簡(jiǎn)寫(xiě)（3.2.19以上版本支持）：{form form=表單的id site=站點(diǎn)id ....}{/form}
三、參數(shù)介紹（紅色表示必填參數(shù)，藍(lán)色表示系統(tǒng)默認(rèn)參數(shù)）
| 參數(shù) | 介紹 |
|---|---|
| action | form |
| form | 要查詢表單的id號(hào)，必須填寫(xiě) |
| site | 站點(diǎn)id，默認(rèn)為當(dāng)前站點(diǎn) |
| field | 可用字段，多個(gè)字段以小寫(xiě)分號(hào)分開(kāi)，默認(rèn)全部字段（為了提高緩存效率，建議填寫(xiě)此選項(xiàng)） |
| order | 排序方式，多個(gè)排序以小寫(xiě)分號(hào)分開(kāi)，默認(rèn)降序排列，例如inputtime_asc表示按錄入時(shí)間升序排列 |
| num | 表示顯示數(shù)量，支持定點(diǎn)查詢，例如1,2表示從第1條記錄開(kāi)始，共顯示2條數(shù)據(jù) |
| page | 當(dāng)page=1時(shí)表示開(kāi)啟分頁(yè)查詢，否則pagesize與urlrule是不會(huì)生效的 |
| pagesize | 分頁(yè)顯示數(shù)據(jù)量，默認(rèn)值為10條 |
| urlrule | 分頁(yè)地址規(guī)則：[page]表示分頁(yè)標(biāo)識(shí)符（此參數(shù)不存在時(shí)分頁(yè)無(wú)效） |
| cache | 緩存時(shí)間單位秒，默認(rèn)關(guān)閉緩存；當(dāng)cache=3600時(shí)，表示緩存時(shí)間1小時(shí)，建議數(shù)據(jù)查詢的標(biāo)簽都加上緩存參數(shù) |
| return | 默認(rèn)返回變量為t，調(diào)用方式就是{$t.字段值}（多級(jí)list查詢必須設(shè)置return=其他字母，否則你懂得） |
四、返回變量
| 變量 | 參數(shù) |
|---|---|
| {$error} | 當(dāng)查詢不到數(shù)據(jù)時(shí)，會(huì)返回錯(cuò)誤信息，調(diào)試模板時(shí)很有用哦（寫(xiě)在list標(biāo)簽以外） |
| {$sql} | 顯示當(dāng)前查詢的sql語(yǔ)句，調(diào)試模板時(shí)候很有用哦（寫(xiě)在list標(biāo)簽以外） |
| {$total} | 用于分頁(yè)時(shí)查詢的總記錄數(shù)量（寫(xiě)在list標(biāo)簽以外） |
| {$count} | 當(dāng)前查詢的記錄，當(dāng)存在分頁(yè)時(shí)，表示當(dāng)前頁(yè)的記錄數(shù)（寫(xiě)在list標(biāo)簽以外） |
| {$pages} | 顯示分頁(yè)代碼（寫(xiě)在list標(biāo)簽以外） |
| {$key} | 當(dāng)前記錄指針位置，從0開(kāi)始（寫(xiě)在list標(biāo)簽以內(nèi)） |
| 當(dāng)存在return=字母時(shí)，以上變量都要寫(xiě)成這種格式{$變量_字母}，例如{list ...reutrn=a}時(shí)，變量格式{$key_a} | |
| {$is_first} | 判斷是否第一條，{if $is_first}第一條{/if} |
| {$is_last} | 判斷是否最后一條，{if $is_last}最后一條{/if} |
五、顯示字段
{$t.字段名稱}或者{$t['字段名稱']}
其他字段請(qǐng)參看后臺(tái)“數(shù)據(jù)備份”中單擊以站點(diǎn)id_form_表單表名稱的表就知道了，字段有說(shuō)明的
六、字段修飾符
| 修飾符 | 介紹 |
|---|---|
| LIKE_字段 | 模糊匹配查詢，例如LIKE_title=%名稱%，表示like title '%名稱%' |
| IN_字段 | IN子句查詢，例如IN_id=1,2,3,4 ，表示id in (1,2,3,4) |
| BETWEEN_字段 | 兩者之間查詢，例如BETWEEN_id=1,100，表示id在1到100的數(shù)據(jù) |
| 字段=值 | 字段條件查詢，例如title=123，表示主題title=123的數(shù)據(jù) |
七、相關(guān)例子
1、調(diào)用默認(rèn)站點(diǎn)的留言表單（假設(shè)id=1）的最新10條數(shù)據(jù)
{list action=form form=1 order=inputtime num=10}
主題：{$t.title}....
時(shí)間：{$t.inputtime}
自定義更新時(shí)間：{dr_date($t._inputtime, 'Y-m-d')}
{/list}
{$error}2、調(diào)用默認(rèn)站點(diǎn)的留言表單（假設(shè)id=1）的所有數(shù)據(jù)并分頁(yè)，每頁(yè)5條
{list action=form form=1 order=inputtime page=1 pagesize=5 urlrule=index.php?page=[page]}
主題：{$t.title}....
{/list}
{$pages}// 分頁(yè)輸出字符串
{$error}
urlrule是分頁(yè)規(guī)則，根據(jù)你的實(shí)際頁(yè)面來(lái)寫(xiě)，你懂得3、表單自定義字段篩選
myfield是我自定義的主表字段，3333是我的值，下面的語(yǔ)法就是篩選出這個(gè)值的數(shù)據(jù)
{list action=form form=1 myfield=33333 order=inputtime num=10}
主題：{$t.title}....
時(shí)間：{$t.inputtime}
自定義更新時(shí)間：{dr_date($t._inputtime, 'Y-m-d')}
{/list}
{$debug}
文檔最后更新時(shí)間：2018-09-29 11:31:41