`tagDataList`如何使用`pagination`标签为指定Tag下的文档列表生成分页？
作为一名资深的网站运营专家，我深知内容组织与用户体验在今天数字世界中的重要性。在安企CMS（AnQiCMS）这样高效且功能丰富的系统里，如何将海量内容以最友好的方式呈现给用户，同时兼顾搜索引擎优化，是我们需要不断思考和实践的课题。今天，我们就来深入探讨安企CMS中一个既实用又强大的组合：如何巧妙运用tagDataList标签配合pagination标签，为指定Tag下的文档列表生成精准且流畅的分页。
安企CMS以其基于Go语言的高性能架构、灵活的内容模型和出色的SEO工具，成为许多企业和内容运营团队的首选。它不仅提供了文章、产品等核心内容类型，更通过强大的标签（Tag）功能，帮助我们对内容进行更细粒度的分类和关联。
理解安企CMS的Tag标签功能
在安企CMS中，Tag标签不仅仅是一个简单的关键词，它更是一种强大的内容组织方式。通过为文档添加标签，我们可以将散落在不同分类下的相关内容聚拢起来，形成一个以特定主题为核心的“微型专题页”。例如，一篇关于“网站性能优化”的文章，可能属于“SEO技巧”分类，同时也可以被打上“前端技术”、“Go语言开发”等标签。用户在浏览某个标签页面时，能迅速发现所有与该标签关联的文档，极大地提升了内容发现的效率和用户的浏览体验。
安企CMS为标签提供了独立的页面模板，通常位于tag/list.html或tag_list.html，这些页面正是我们展示特定Tag下文档列表的**舞台。
核心功能：tagDataList标签的魅力
要在这些标签页面上展示文档，tagDataList标签是我们的核心工具。顾名思义，它专门用于获取与某个Tag关联的文档数据列表。它能够根据我们指定的Tag ID，智能地检索出所有包含该标签的文章或产品。
使用tagDataList标签时，我们通常会关注以下几个重要参数：
tagId：这是指定我们想要获取哪个Tag下文档列表的关键参数。如果您当前正处于一个Tag详情页面，安企CMS会非常智能地自动识别并使用当前页面的Tag ID，您甚至无需显式指定。moduleId：如果您希望只显示特定内容模型（例如文章模型或产品模型）下的文档，可以通过这个参数进行筛选。order：文档的排序方式。您可以根据发布时间（id desc）、浏览量（views desc）或后台自定义排序（sort desc）来展示内容，以满足不同的内容策略。limit：控制每次查询返回的文档数量。这在配合分页标签时尤为重要，它决定了每页显示多少条文档。type="page"：这是实现分页功能的关键！ 当我们将type参数设置为"page"时，tagDataList将不再仅仅返回一个固定数量的列表，而是会为后续的pagination标签准备好完整的页码和分页数据。
tagDataList标签会将获取到的文档列表存储在一个可遍历的变量中，例如archives。在模板中，我们可以通过循环遍历archives，获取到每篇文档的Id、Title、Link、Description、CreatedTime等详细信息，并按需进行展示。
分页的魔法：pagination标签
当一个Tag下的文档数量达到数十甚至上百篇时，一次性全部加载不仅影响页面性能，也会让用户感到信息过载。这时，pagination标签就发挥了它的神奇作用。它能够根据tagDataList提供的数据，自动生成一个包含首页、上一页、具体页码、下一页和末页的完整分页导航。
pagination标签的常用参数是：
show：用来控制在分页导航中显示多少个具体的页码链接。比如show="5"会显示当前页前后最多5个页码。
pagination标签会创建一个名为pages的对象（当然，您也可以自定义其变量名），这个对象包含了分页所需的所有信息：
TotalItems：总共有多少篇文档。TotalPages：总共有多少页。CurrentPage：当前用户所在的页码。FirstPage、LastPage、PrevPage、NextPage：这些都是页面对象，提供了对应的链接（Link）和显示名称（Name），让我们可以轻松构建导航。Pages：这是一个数组，包含了所有需要显示的页码链接。通过遍历这个数组，我们可以动态生成中间的页码导航。数组中的每个元素又是一个对象，包含Name（页码数字）、Link（页码链接）和IsCurrent（是否为当前页，用于样式高亮）。
实战演练：tagDataList与pagination的完美结合
现在，让我们通过一个具体的模板代码示例，看看tagDataList和pagination是如何携手工作的。这段代码通常会放在您的tag/list.html或tag_list.html模板文件中。
假设我们要展示一个标签下的文章列表，每页显示10篇文章，并提供最多显示5个页码的分页导航：
”`twig {# 首先，获取指定Tag下的文档列表。 在Tag详情页面，tagId通常会自动识别，无需显式设置。 type=“page”是关键，它告诉系统为分页做准备。 limit=“10”则设定了每页显示10篇文档。 #} {% tagDataList archives with type=“page” limit=“10” order=“id desc” %}
<div class="tag-document-list">
{% for item in archives %}
<article class="document-item">
<h2><a href="{{item.Link}}">{{item.Title}}</a></h2>
<div class="meta-info">
<span>发布于：{{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
<span>浏览量：{{item.Views}}</span>
{# 如果需要显示文档分类，可以结合 categoryDetail 标签 #}
<span>分类：<a href="{% categoryDetail with name='Link' id=item.CategoryId %}">{% categoryDetail with name='Title' id=item.CategoryId %}</a></span>
</div>
<p>{{item.Description}}</p>
{% if item.Thumb %}
<div class="thumbnail">
<a href="{{item.Link}}"><img src="{{item.Thumb}}" alt="{{item.Title}}"></a>
</div>
{% endif %}
<a href="{{item.Link}}" class="read-more">阅读更多 »</a>
</article>
{% empty %}
{# 当Tag下没有文档时，显示此内容 #}
<p class="no-content-message">当前标签下暂无相关文档。</p>
{% endfor %}
</div>
{# 接着，使用 pagination 标签生成分页导航。
show="5" 表示最多显示5个页码链接（不含首页、尾页、上下页）。 #}
<nav class="pagination-navigation">
{% pagination pages with show="5" %}
<ul>
{# 首页链接 #}
<li class="page-item {% if pages.FirstPage.IsCurrent %}active{% endif %}">
<a href="{{pages.FirstPage.Link}}">{{pages.FirstPage.Name}}</a>
</li>
{# 上一页链接，仅在存在时显示 #}
{% if pages.PrevPage %}
<li class="page-item">
<a href="{{pages.PrevPage.Link}}">{{pages.PrevPage.Name}}</a>
</li>
{% endif %}
{# 中间页码链接列表 #}
{% for pageItem in pages.Pages %}
<li class="page-item {% if pageItem.IsCurrent %}active{% endif %}">
<a href="{{pageItem.Link}}">{{pageItem.Name}}</a>
</li>
{% endfor %}
{# 下一页链接，仅在存在时显示 #}
{% if pages.NextPage %}
<li class="page-item">
<a href="{{pages.NextPage.Link}}">{{pages.NextPage.Name}}</a>
</li>