# 列表標簽 描述：輸出列表數據如：新聞列表，圖片列表 | 額外參數 | 說明 |必須| | --- | --- | --- | | @catid | 欄目列表id，列表頁，內容頁可以使用 $catid 獲取當前欄目id，【modelid】參數有值時，可省略此參數 | 否 | | @modelid | 模型id，列表頁，內容頁可以使用 $modelid 獲取當前模型id，【catid】參數有值時，可省略此參數 |否 | | @order| 排序，例如：order="id DESC" ，隨機可以使用order="[rand]"|否 | | @field| 取出指定字段(副表無效，副表全部取出)，例如：field="title,catid,id" |否 | | @flag| 內容屬性，例如:?flag="4,5" 多個用逗號隔開??屬說明:?置頂[1]??頭條[2]??特薦[3]?推薦[4]?熱點[5]?幻燈[6] |否| | @limit| 指定返回數據量 例如：limit="5,10" ，不得和@num共存,共存則優先使用limit |否 | | @num| 每次返回數據量 例如：num="5" |否 | | @where| sql語句的where部分 例如：thumb != '' AND status = 1| 否 | | @moreinfo| 是否調用副表數據 1為是 0為否 默認為否| 否 | | @page| 當前分頁號，默認$page，當傳入該參數表示啟用分頁，一個頁面只允許有一個page，多個標簽使用多個page會造成不可預知的問題。 | 否 | |@simple|例如：simple="true"代表簡潔模式，只有上下頁，為數字時代表總記錄數|否| |@pagepath|具體使用方法請查看【技巧/問題】-【分頁偽靜態】|否| > moreinfo參數屬性：本參數表示在返回數據的時候，會把副表中的數據也一起返回。一個內容模型分為2個表，一個主表一個副表，主表中一般是保存了標題、所屬欄目等等短小的數據（方便用于索引），而副表則保存了大字段的數據，如內容等數據。在模型管理中新建字段的時候，是允許你選擇存入到主表還是副表的（我們推薦的是，把不重要的信息放到副表中）。想要在列表中調取副表的數據就需要在標簽中使用moreinfo這個屬性。 > pages參數屬性：輸出分頁{$pages|raw}， 其中@num參數控制多少條分頁 簡單示例： ``` {yzn module="cms" action="lists" catid="$catid" cache="3600" order="listorder ASC" num="10" page="$page" return="data"} {volist name="data" id="vo"} ...HTML... {/volist} {/yzn} ``` > PS:如果指定多個欄目可以用where="catid in(5,6,7,8)" ，這些id必須屬于一個模型 > @catid可以省略，但是@modelid參數必須指定 > 比如 {yzn module="cms" action="lists" where="catid in(5,6,7,8)" modelid="3" order="listorder ASC" num="10" return="data"} 完整示例： ``` //輸出當前欄目id的列表10條文章 帶分頁并緩存3600秒 <!--S 列表循環開始--> {yzn module="cms" action="lists" catid="$catid" cache="3600" order="listorder ASC" num="10" page="$page" return="data"} {volist name="data" id="vo"} <li class="item clearfix"> <a href="{$vo.url}" title="{$vo.title}"><img class="fl" src="{$vo.thumb}" alt="{$vo.title}"> <div class="time fr"><span class="day">{$vo.update_time|date="m-d"}</span><span class="year">{$vo.update_time|date="Y"}</span></div> <h3>{$vo.title}</h3> <div class="txt">{$vo.description|str_cut=###,60}</div> </a> </li> {/volist} {/yzn} <!--E 列表循環結束--> <!--S 分頁開始--> {$pages|raw} <!--E 分頁結束--> 輸出總頁數{$data->total()}，只有標簽使用分頁才能使用 ``` | 返回變量 | 說明 | | --- | --- | | @id | 欄目id | | @catid | 欄目列表id | | @url | 文章url路徑 | | @title | 文章標題 | | @thumb | 縮略圖 | | @hits | 文章點擊次數 | | @keywords | SEO關鍵詞 | | @description | SEO描述 | | @create_time | 文章發布時間 `1.1.2 以下版本為inputtime` | | @update_time | 文章更新時間 `1.1.2 以下版本為updatetime`| | @content | 文章內容（建副表才有） | | @更多字段名稱|這里指的是您該模型建的字段名稱 | **根據模型字段類型不同 輸出方式也不同如下：** | 類型 |輸出方式 | | --- | --- | | 單選按鈕 / 下拉框 | 鍵：`{$vo.字段名稱}` 值：{$vo.字段名稱_text} | | 輸入框 / 多行文本 / 數字 / 開關 / 日期和時間 / 顏色值 / 單圖片 / | `{$vo.字段名稱}` | | 復選框 / 數組 / 多圖片 | {volist name="$vo['字段名稱']" id="v"}<br>值：{$key}<br>描述：{$v}<br>{/volist} |