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