模板开发

使用模板标签前请先通读 Nunjucks 手册

模版标签使用

在 DoraCMS 中我们把 {% %} 作为开始结束标签。DoraCMS 模版标签的是以下面的方式进行声明

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

模版标签必须以 {% 开头,并以 %} 结尾的代码片段,如果不正确会引起程序致命性的错误,导致程序无法继续运行。

模版标签分析

标签中 {% 后的 remote 是固定的,通过 remote 标记,我们可以使用服务端定义的方法来请求数据

key="tabContents"

这是开发者指定的变量,代表的是返回数组接收的变量。

api="content/getList"

这是获取数据指定的api,在模板中展示的数据主要来自api,数据获取是异步的。

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

query 是选填的,包含了在接口请求过程中需要携带的参数,query 中约定了几个参数可以传递:

变量名默认值备注
current1当前页码
pageSize10每页数量
isPaging1是否分页 0:不分页 1:分页

这个形式所代表的是参数。每一个模型都为其模版标签定义了调用的参数。其中有一些调用参数是系统保留的参数,其对所有的模版标签都是有效的。

参数必须使用

参数名="参数值"

的方式填写,多个参数之间使用’,’分开(如下例),参数值可使用双引号来包括,无论是什么形式的引号都必须是成对出现的。

{% remote key="demoKey", 参数名="参数值",参数名="参数值",参数名="参数值" %}

请查看模版表情标签保留参数相关章节,以了解具体保留参数及其用途。

如何显示模版标签中的数据

默认情况下模版标签中的数据都是数组方式返回的,你都可以通过 你在模版标签中定义key的参数来接收返回的数组。 比如上例定义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}}需要具体根据所使用的模版标签,返回的数据来判断。

模版标签保留参数

下表为模版标签保留参数表,几乎所有的模版标签都支持这些保留参数设置

变量名默认值备注
key-定义接收数据参数
api-获取数据的接口
query-接口请求携带的参数

下例中是首页请求热门标签的例子。

{% remote key='hotTags',api="contentTag/getList",query='{"isPaging":"0"}' %}
{% for tagItem in hotTags %}
<a href="http://www.w3c6.com/tag/{{tagItem.name}}" target="_blank">{{tagItem.name}}</a>
{% endfor %}
Copyright © doramart 2019 all right reserved


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号

意见反馈
返回顶部