说明:当我们跟文档打上各种tag后,我们就可以用文档Tag列表标签来调用这些Tag。
使用方法:{% tagList 变量名 with limit="10" %}
如将变量定义为 tags {% tagList tags with limit="10" %}...{% endtagList %}
tagList 支持的参数有:
- 文档ID
itemId
itemId
如果没有指定,默认读取当前文档的ID,也可以手工指定,读取指定的文档的Tag列表。如果想展示所有的Tag,而不自动读取当前文档ID的Tag,则设置itemId="0"
- 调用数量
limit
如果不指定,默认最多显示10个,可以设置的范围是1~100,limit
在不是分页列表的时候,支持offset
模式,也就是,
分隔模式,如想从第2条开始,获取10条数据,可以设置成limit="2,10"
。 - 索引字母
letter
可以填写的值范围为 A-Z - Tag分类ID
categoryId
如果需要显示指定分类的Tag,则可以通过categoryId="分类ID"
来指定。如果需要指定多个分类ID,可以用英文,
隔开。如categoryId="1,2,3"
。 - 站点ID
siteId
siteId
一般不需要填写,如果你使用后台的多站点管理创建了多个站点,并且想调用其他站点的数据,则可以通过指定siteId
来实现调用指定站点的数据。
tags 是一个数组对象,因此需要使用 for
循环来输出
item 为 for循环体内的变量,可用的字段有:
- TagID
Id
- Tag标题
Title
- Tag链接
Link
- Tag描述
Description
- Tag索引字母
FirstLetter
- Tag的分类ID
CategoryId
代码示例
<div>
文档Tag:
{% tagList tags with limit="10" %}
{% for item in tags %}
<a href="{{item.Link}}">{{item.Title}}</a>
{% endfor %}
{% endtagList %}
</div>
文档Tag列表分页显示
文档Tag列表支持分页,但仅在模板 tag/index.html
内生效。
<div>
{% tagList tags with type="page" limit="20" %}
<ul>
{% for item in tags %}
<li>
<a href="{{item.Link}}">
<h5>{{item.Title}}</h5>
<div>{{item.Description}}</div>
</a>
</li>
{% empty %}
<liå>
该列表没有任何内容
</li>
{% endfor %}
</ul>
{% endtagList %}
</div>
{# 分页代码 #}
<div>
{% pagination pages with show="5" %}
{# 首页 #}
<a class="{% if pages.FirstPage.IsCurrent %}active{% endif %}" href="{{pages.FirstPage.Link}}">{{pages.FirstPage.Name}}</a>
{# 上一页 #}
{% if pages.PrevPage %}
<a href="{{pages.PrevPage.Link}}">{{pages.PrevPage.Name}}</a>
{% endif %}
{# 中间多页 #}
{% for item in pages.Pages %}
<a class="{% if item.IsCurrent %}active{% endif %}" href="{{item.Link}}">{{item.Name}}</a>
{% endfor %}
{# 下一页 #}
{% if pages.NextPage %}
<a href="{{pages.NextPage.Link}}">{{pages.NextPage.Name}}</a>
{% endif %}
{# 尾页 #}
<a class="{% if pages.LastPage.IsCurrent %}active{% endif %}" href="{{pages.LastPage.Link}}">{{pages.LastPage.Name}}</a>
{% endpagination %}
</div>
</div>