模板開發(fā)

使用模板標(biāo)簽前請先通讀 Nunjucks 文檔

模版標(biāo)簽使用

在 DoraCMS 中我們把 {% %} 作為開始結(jié)束標(biāo)簽。DoraCMS 模版標(biāo)簽的是以下面的方式進行聲明

{% remote key="tabContents",api="content/getList",query='{"model":"1","pageSize":7,"isPaging":"0","typeId":"Ek7skiaw"}' %}

模版標(biāo)簽必須以 {％ 開頭，并以 ％} 結(jié)尾的代碼片段，如果不正確會引起程序致命性的錯誤，導(dǎo)致程序無法繼續(xù)運行。

模版標(biāo)簽分析

標(biāo)簽中 {％ 后的 remote 是固定的，通過 remote 標(biāo)記，我們可以使用服務(wù)端定義的方法來請求數(shù)據(jù)

key="tabContents"

這是開發(fā)者指定的變量，代表的是返回數(shù)組接收的變量。

api="content/getList"

這是獲取數(shù)據(jù)指定的api，在模板中展示的數(shù)據(jù)主要來自api，數(shù)據(jù)獲取是異步的。

query='{"model":"1","pageSize":7,"isPaging":"0","typeId":"Ek7skiaw"}'

query 是選填的，包含了在接口請求過程中需要攜帶的參數(shù)，query 中約定了幾個參數(shù)可以傳遞：

這個形式所代表的是參數(shù)。每一個模型都為其模版標(biāo)簽定義了調(diào)用的參數(shù)。其中有一些調(diào)用參數(shù)是系統(tǒng)保留的參數(shù)，其對所有的模版標(biāo)簽都是有效的。

參數(shù)必須使用

參數(shù)名="參數(shù)值"

的方式填寫，多個參數(shù)之間使用’,’分開（如下例），參數(shù)值可使用雙引號來包括，無論是什么形式的引號都必須是成對出現(xiàn)的。

{% remote key="demoKey", 參數(shù)名="參數(shù)值",參數(shù)名="參數(shù)值",參數(shù)名="參數(shù)值" %}

請查看模版表情標(biāo)簽保留參數(shù)相關(guān)章節(jié)，以了解具體保留參數(shù)及其用途。

如何顯示模版標(biāo)簽中的數(shù)據(jù)

默認情況下模版標(biāo)簽中的數(shù)據(jù)都是數(shù)組方式返回的，你都可以通過 你在模版標(biāo)簽中定義key的參數(shù)來接收返回的數(shù)組。 比如上例定義key為 'demoKey' ，你可以使用如下的方式來顯示值：

<ul>
{% for val in demoKey%}
<li><a href="{{val.name|get_url(val.id)}}">{{val.title}}</a></li>
{% endfor %}
</ul>

基中的{{val.name}},{{val.id}}和{{val.title}}需要具體根據(jù)所使用的模版標(biāo)簽，返回的數(shù)據(jù)來判斷。

模版標(biāo)簽保留參數(shù)

下表為模版標(biāo)簽保留參數(shù)表，幾乎所有的模版標(biāo)簽都支持這些保留參數(shù)設(shè)置

下例中是首頁請求熱門標(biāo)簽的例子。

{% remote key='hotTags',api="contentTag/getList",query='{"isPaging":"0"}' %}
{% for tagItem in hotTags %}
<a href="/tag/{{tagItem.name}}" target="_blank">{{tagItem.name}}</a>
{% endfor %}