首页 安企CMS模板标签手册 文档Tag标签

文档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

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>