一、作用
用于萬能的任意表查詢內(nèi)容數(shù)據(jù)（支持分頁查詢）
二、語法
{list action=table table=表名....}{/list}
簡寫（3.2.19以上版本支持）：{table table=表名....}{/table }
三、參數(shù)介紹（紅色表示必填參數(shù)，藍色表示系統(tǒng)默認參數(shù)）
| 參數(shù) | 介紹 |
|---|---|
| action | table |
| table | 不含前綴的表名稱，例如會員表，填寫member |
| field | 可用字段，多個字段以小寫分號分開，默認全部字段（為了提高緩存效率，建議填寫此選項） |
| order | 排序方式，多個排序以小寫分號分開，默認降序排列，例如updatetime_asc表示按更新時間升序排列 |
| num | 表示顯示數(shù)量，支持定點查詢，例如1,2表示從第1條記錄開始，共顯示2條數(shù)據(jù) |
| page | 當page=1時表示開啟分頁查詢，否則pagesize與urlrule是不會生效的 |
| pagesize | 分頁顯示數(shù)據(jù)量 |
| urlrule | 分頁地址規(guī)則：[page]表示分頁標識符 |
| join | 關聯(lián)表查詢 （2.7.0中有效） |
| on | 關聯(lián)條件，格式為on=關聯(lián)字段,被關聯(lián)字段 |
| cache | 緩存時間單位秒，默認關閉緩存；當cache=3600時，表示緩存時間1小時，建議數(shù)據(jù)查詢的標簽都加上緩存參數(shù) |
| return | 默認返回變量為t，調(diào)用方式就是{$t.字段值}（多級list查詢必須設置return=其他字母，否則你懂得） |
四、返回變量
| 變量 | 參數(shù) |
|---|---|
| {$error} | 當查詢不到數(shù)據(jù)時，會返回錯誤信息，調(diào)試模板時很有用哦（寫在list標簽以外） |
| {$sql} | 顯示當前查詢的sql語句，調(diào)試模板時候很有用哦（寫在list標簽以外） |
| {$total} | 用于分頁時查詢的總記錄數(shù)量（寫在list標簽以外） |
| {$count} | 當前查詢的記錄，當存在分頁時，表示當前頁的記錄數(shù)（寫在list標簽以外） |
| {$pages} | 顯示分頁代碼（寫在list標簽以外） |
| {$key} | 當前記錄指針位置，從0開始（寫在list標簽以內(nèi)） |
| 當存在return=字母時，以上變量都要寫成這種格式{$變量_字母}，例如{list ...reutrn=a}時，變量格式{$key_a} | |
| {$is_first} | 判斷是否第一條，{if $is_first}第一條{/if} |
| {$is_last} | 判斷是否最后一條，{if $is_last}最后一條{/if} |
五、顯示字段
{$t.字段名稱}或者{$t['字段名稱']}
其他字段請參看后臺“數(shù)據(jù)結(jié)構(gòu)”中單擊相應的表就知道了，字段有說明的
六、字段修飾符
| 修飾符 | 介紹 |
|---|---|
| LIKE_字段 | 模糊匹配查詢，例如LIKE_title=%名稱%表示like title '%標題%' |
| IN_字段 | IN子句查詢，例如IN_id=1,2,3,4表示id in (1,2,3,4) |
| BEWTEEN_字段 | 兩者之間查詢，例如BEWTEEN_id=1,100表示id在1到100的數(shù)據(jù) |
| 字段=值 | 字段條件查詢，例如uid=1表示會員id=1的數(shù)據(jù) |
七、部分實例
1、顯示會員表數(shù)據(jù)，num表示顯示10條，order表示按注冊時間排序，默認cache緩存時間10小時
{list action=table table=member order=regtime num=10}
會員：{$t.username}
注冊時間：{dr_date($t.regtime, 'Y-m-d')}
{/list}2、調(diào)用10條最新的會員動態(tài)
{list action=table table=sns_feed order=inputtime num=10}
會員：{$t.username}
動態(tài)：{dr_sns_content($t.content)}
{/list}3、會員表關聯(lián)空間表查詢（v2.7.0以后版本有效）
{list action=table table=member join=space on=uid,uid order=hits num=10}
會員：{$t.username}
空間標題：{$t.title}
{/list}
文檔最后更新時間：2018-09-29 14:34:26