為了方便大家在模板里面快速的調用數據庫內容,Sycms基于TP自帶的標簽庫擴展功能,為大家集成了通用標簽庫(循環標簽)功能。下面將具體說明通用標簽的使用。
## 什么是標簽
標簽存在的意義就是將復雜的原始PHP數據調用語句封裝為簡單易懂的格式化標簽,便于歸納整理及團隊協作。比如,讓前端工程師直接完成數據的調用而無需知道其內部的構造及原理。
## 循環標簽庫
循環標簽通常用于對數組或對象的循環輸出,一般在模板中以「列表」的形式體現。基本格式如下:
~~~
<ul>
{sy_list where="['isover'=>'1']" order="allvisit desc" limit="30" key='full'}
<li>{$item.novel.name}</li>
{/sy_list}
</ul>
~~~
## 循環標簽屬性詳解
| 參數 | 說明 | 默認值 | 描述 |
| --- | --- | --- | --- |
| where | 表查詢條件 | 無 | 注意:如查詢條件為拼裝字符串需用單引號引起來,字符串帶變量查詢示例:'cid = '.$cid.' and status > 0',數組帶查詢示例:\['cid' => $cid, 'status' => \['gt', 0\]\] |
| order | 返回結果排序 | 無 | 示例值:id desc |
| limit | 限制返回結果數量 | 20 | 只能填寫正整數 |
| page | 分頁頁碼 | 1 | 只能填寫正整數 |
| key | 緩存標識 | i | 示例值:k |
## 標簽嵌套示例代碼
~~~
{sy_list where="['isover'=>'1']" order="allvisit desc" limit="30" key='full'}
<div class="block">
<div class="block_img">
<a href="{$item.url.novel}"><img src="{$item.novel.cover}" alt="{$item.novel.name}" onerror="this.src='__IMAGES__/nopic.gif'"></a>
</div>
<div class="block_txt">
<p>
<a href="{$item.url.novel}">
<h2>{$item.novel.name}</h2>
</a>
</p>
<p>
作者:{$item.author.name}
</p>
<p>
時間:{$item.last.mtime|date='m-d'}
</p>
<p>{$item.novel.intro}</p>
</div>
</div>
{/sy_list}
~~~