`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">阅读更多 &raquo;</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>