一、作用
用于會員模型列表循環(huán)查詢
二、語法
{list action=model modelid=模型id space=空間uid ....}{/list}
三、參數(shù)介紹(紅色表示必填參數(shù),藍(lán)色表示系統(tǒng)默認(rèn)參數(shù))
| 參數(shù) | 介紹 |
|---|---|
| action | model |
| modelid | 會員空間模型id號,必須填寫 |
| space | 會員空間的uid號(空間主人的uid) |
| field | 可用字段,多個字段以小寫分號分開,默認(rèn)全部字段(為了提高緩存效率,建議填寫此選項) |
| order | 排序方式,多個排序以小寫分號分開,默認(rèn)降序排列,例如updatetime_asc表示按更新時間升序排列 |
| num | 表示顯示數(shù)量,支持定點查詢,例如1,2表示從第1條記錄開始,共顯示2條數(shù)據(jù) |
| page | 當(dāng)page=1時表示開啟分頁查詢,否則pagesize與urlrule是不會生效的 |
| pagesize | 分頁顯示數(shù)據(jù)量,默認(rèn)值為10條 |
| urlrule | 分頁地址規(guī)則:[page]表示分頁標(biāo)識符(此參數(shù)不存在時分頁無效) |
| cache | 緩存時間單位秒,默認(rèn)關(guān)閉緩存;當(dāng)cache=3600時,表示緩存時間1小時,建議數(shù)據(jù)查詢的標(biāo)簽都加上緩存參數(shù) |
| return | 默認(rèn)返回變量為t,調(diào)用方式就是{$t.字段值}(多級list查詢必須設(shè)置return=其他字母,否則你懂得) |
四、返回變量
| 變量 | 參數(shù) |
|---|---|
| {$error} | 當(dāng)查詢不到數(shù)據(jù)時,會返回錯誤信息,調(diào)試模板時很有用哦(寫在list標(biāo)簽以外) |
| {$sql} | 顯示當(dāng)前查詢的sql語句,調(diào)試模板時候很有用哦(寫在list標(biāo)簽以外) |
| {$total} | 用于分頁時查詢的總記錄數(shù)量(寫在list標(biāo)簽以外) |
| {$count} | 當(dāng)前查詢的記錄,當(dāng)存在分頁時,表示當(dāng)前頁的記錄數(shù)(寫在list標(biāo)簽以外) |
| {$pages} | 顯示分頁代碼(寫在list標(biāo)簽以外) |
| {$key} | 當(dāng)前記錄指針位置,從0開始(寫在list標(biāo)簽以內(nèi)) |
| 當(dāng)存在return=字母時,以上變量都要寫成這種格式{$變量_字母},例如{list ...reutrn=a}時,變量格式{$key_a} | |
五、顯示字段
{$t.字段名稱}或者{$t['字段名稱']}
其他字段請參看后臺“插件-數(shù)據(jù)結(jié)構(gòu)-點擊對應(yīng)的表”中單擊以space_模型名稱的表就知道了,字段有說明的
由于欄目catid由會員自己創(chuàng)建,因此最好不要把欄目catid作為查詢條件,否則其他會員的欄目看不到數(shù)據(jù)的,可能你懂得!
六、相關(guān)例子
1、調(diào)用會員1的模型id=5的所有數(shù)據(jù)并分頁(支持所有模板)
{list action=model modelid=5 space=1 page=1 pagesize=10 urlrule=index.php?page=[page]}
標(biāo)題:{$t.title}
地址:{dr_space_show_url($spaceid, 5, $t.id)}
地址有點特殊,第二個參數(shù)5是模型的id號
其他字段按你自己設(shè)置的字段調(diào)用
更新時間:{$t.updatetime}
自定義更新時間:{dr_date($t._updatetime, 'Y-m-d')}
{/list}
{$pages}分頁輸出代碼
{$error}錯誤信息顯示2、在空間模板中調(diào)用當(dāng)前空間的模型id=5的前10條數(shù)據(jù)($spaceid只能在空間模板中使用)
{list action=model modelid=5 space=$spaceid num=10 order=updatetime}
標(biāo)題:{$t.title}
地址:{dr_space_show_url($spaceid, 5, $t.id)}
地址有點特殊,第二個參數(shù)5是模型的id號
其他字段按你自己設(shè)置的字段調(diào)用
更新時間:{$t.updatetime}
自定義更新時間:{dr_date($t._updatetime, 'Y-m-d')}
{/list}
{$error}錯誤信息顯示3、在空間模板中調(diào)用當(dāng)前空間模型id=10的數(shù)據(jù),并顯示對應(yīng)的欄目分類信息($spaceid只能在空間模板中使用)
{list action=model modelid=10 space=$spaceid num=10 order=updatetime}
標(biāo)題:{$t.title}
欄目名稱:{$category[$t.catid]['name']}
欄目地址:{dr_space_list_url($spaceid, $t.catid)}
內(nèi)容地址:{dr_space_show_url($spaceid, 10, $t.id)}
地址有點特殊,第二個參數(shù)10是模型的id號
一般就只會調(diào)用這兩個吧
更新時間:{$t.updatetime}
自定義更新時間:{dr_date($t._updatetime, 'Y-m-d')}
{/list}
{$error}錯誤信息顯示
文檔最后更新時間:2017-05-22 11:10:12