文档Tag列表标签

说明:当我们跟文档打上各种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>  
问题反馈可加技术微信:tsrz001