如何在Tag文档列表页面实现文档的排序和分页展示？
安企CMS作为一款高效、灵活的内容管理系统，其标签（Tag）功能是组织和发现内容的重要方式。当用户访问某个特定的Tag页面时，往往期望能够看到与该Tag相关的所有文档，并且这些文档能以一种有序、易于浏览的方式呈现。这就涉及到如何在Tag文档列表页面实现文档的排序和分页展示。
在安企CMS中，实现这一功能主要依赖于其强大的模板标签系统，特别是tagDataList标签和pagination标签。通过灵活运用这两个标签及其参数，我们可以轻松构建出用户体验友好的Tag文档列表。
理解Tag文档列表页面的结构
在安企CMS的模板设计中，专门用于展示Tag下文档列表的页面通常是/template/{当前模板目录}/tag/list.html。这个页面是我们在展示特定标签下所有相关文档时的主要操作区域。系统会在此页面自动识别当前访问的Tag信息，我们只需调用相应的标签来获取和渲染数据即可。
核心标签：tagDataList 及其排序功能
tagDataList标签是安企CMS专门用于获取指定Tag下文档列表的核心工具。它能够根据我们提供的Tag ID，检索所有关联的文档。为了实现排序和分页，我们需要关注tagDataList的几个关键参数：
tagId: 这是最基本的参数，用于指定要获取哪个Tag的文档列表。在tag/list.html页面中，通常不需要显式设置tagId，因为系统会自动尝试读取当前Tag页面的Tag ID。type="page": 这个参数至关重要，它告诉系统我们需要为文档列表生成分页数据。设置为"page"后，tagDataList不仅会返回当前页的文档列表，还会隐式地提供一个包含分页信息的pages变量，供pagination标签使用。order: 用于控制文档的排序方式。安企CMS提供了多种排序选项，您可以根据实际需求选择："id desc": 按照文档ID降序排列（通常意味着最新发布的文档在前）。"views desc": 按照文档浏览量降序排列（热门文档在前）。"sort desc": 按照后台自定义的排序值降序排列。 例如，如果我们想让最新发布的文档优先展示，可以将order参数设置为"id desc"；如果希望最受欢迎的文档在前，则设置为"views desc"。
limit: 定义每页显示多少条文档。这是一个非常实用的参数，比如limit="10"表示每页显示10篇文章。
通过结合这些参数，tagDataList便能够输出符合我们排序要求并为分页做好了准备的文档列表。
{% tagDataList archives with type="page" limit="10" order="views desc" %}
{% for item in archives %}
<div class="document-item">
<a href="{{item.Link}}">
<h3>{{item.Title}}</h3>
<p>{{item.Description}}</p>
<span class="info">
发布时间: {{stampToDate(item.CreatedTime, "2006-01-02")}} |
浏览量: {{item.Views}}
</span>
</a>
</div>
{% empty %}
<p>该标签下暂无任何文档。</p>
{% endfor %}
{% endtagDataList %}
在上面的代码片段中，我们指定了每页显示10篇文档，并按照浏览量从高到低进行排序。{% empty %}标签则优雅地处理了当没有文档时显示提示信息的情况。
分页展示：pagination标签的运用
当tagDataList的type参数设置为"page"后，系统会自动生成一个名为pages的变量，其中包含了所有与分页相关的数据，如总页数、当前页、首页、尾页以及前后页链接等。这时，我们就可以利用pagination标签来渲染美观的分页导航了。
pagination标签最常用的参数是show，它决定了在分页导航中显示多少个页码链接。例如，show="5"意味着在当前页码附近最多显示5个页码。
<div class="pagination-container">
{% pagination pages with show="5" %}
<a class="pagination-link {% if pages.FirstPage.IsCurrent %}active{% endif %}" href="{{pages.FirstPage.Link}}">首页</a>
{% if pages.PrevPage %}
<a class="pagination-link" href="{{pages.PrevPage.Link}}">上一页</a>
{% endif %}
{% for item in pages.Pages %}
<a class="pagination-link {% if item.IsCurrent %}active{% endif %}" href="{{item.Link}}">{{item.Name}}</a>
{% endfor %}
{% if pages.NextPage %}
<a class="pagination-link" href="{{pages.NextPage.Link}}">下一页</a>
{% endif %}
<a class="pagination-link {% if pages.LastPage.IsCurrent %}active{% endif %}" href="{{pages.LastPage.Link}}">尾页</a>
{% endpagination %}
</div>
这段代码会根据pages变量中的数据，自动生成一个包含首页、上一页、具体页码、下一页和尾页链接的分页导航。item.IsCurrent可以帮助我们为当前页码添加样式，提升用户识别度。
综合示例：构建完整的Tag文档列表页面
将tagDataList和pagination标签结合起来，我们就可以在tag/list.html模板中实现一个功能完善的Tag文档列表页面：
”`twig {# tag/list.html #} <!DOCTYPE html>
<meta charset="UTF-8">
<title>{% tdk with name="Title" siteName=true