# 模版標簽使用說明 在CmsWing中我們開始需要{% %}作為開始結束標簽。 CmsWing模版標簽的是以下面的方式進行聲明 ~~~ {% topic data = "data",limit= "5",cid="2",type="hot"%} ~~~ 模版標簽必須以{％開頭，并以％}結尾的代碼片段。 如果不正確會引起程序致命性的錯誤，導致程序無法繼續運行。 ## 模版標簽分析 標簽中{％之后跟隨的為數據源。如上面的例子中的'topic'調用的是內容模型的模版標簽 ~~~ data = 'data' ~~~ 這是標簽固定的參數，代表的是返回數組接收的變量。 ~~~ limit = "5" ~~~ 這個形式所代表的是參數。每一個模型都為其模版標簽定義了調用的參數。其中有一些調用參數是系統保留的參數，其對所有的模版標簽都是有效的。 參數必須使用 ~~~ 參數名="參數值" ~~~ 的方式填寫，多個參數之間使用','分開（如下例），參數值可使用雙引號來包括，無論是什么形式的引號都必須是成對出現的。 ~~~ {% topic data="list", 參數名="參數值",參數名="參數值",參數名="參數值" %} ~~~ > 請查看模版表情標簽保留參數相關章節，以了解具體保留參數及其用途。 ## 如何顯示模版標簽中的數據 默認情況下模版標簽中的數據都是數組方式返回的，你都可以通過 你在模版標簽中定義data的參數來接收返回的數組。 比如上例定義data為'data'，你可以使用如下的方式來顯示值： ~~~ <ul> {% for val in data%} <li><a href="{{val.name|get_url(val.id)}}">{{val.title}}</a></li> {% endfor %} </ul> ~~~ 基中的{{val.name}},{{val.id}}和{{val.title}}需要具體根據所使用的模版標簽，返回的數據來判斷。 get_url() 是獲取本條內容鏈接，使用方法 {{內容識別｜get_url(內容ID)}} 這些后面會詳細介紹。 # 模版標簽保留參數 下表為模版標簽保留參數表，幾乎所有的模版標簽都支持這些保留參數設置 | 變量名 | 默認值 | 說明 | | -- | -- | -- | | data | data | 返回數據變量名 | | cache | 0 | 緩存存儲時間（單位秒） | | limit | 10 | 獲取記錄的條數 | 下例中是一個完整的使用例子。 ~~~ {% topic data = "data",limit= "5",cid="2",type="hot"%} <ul> {% for val in data%} <li><a href="{{val.name|get_url(val.id)}}">{{val.title}}</a></li> {% endfor %} </ul> ~~~