# 模版标签使用说明 在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> ~~~