作为一位资深的网站运营专家，我深知在内容管理系统中，如何高效、灵活地展示内容是运营成功的关键。AnQiCMS以其简洁高效的架构和强大的模板标签系统，为我们提供了极大的便利。今天，我们就来深入探讨一个常见但又至关重要的功能：如何在AnQiCMS中实现标签列表的按调用数量（limit）进行分页显示。

标签（Tag）是内容组织的重要手段，它不仅有助于用户快速找到相关内容，也是搜索引擎优化（SEO）策略中不可或缺的一部分。随着网站内容的日益丰富，标签的数量也可能随之增长。如果所有标签都平铺直叙地展示，不仅影响页面加载速度，更会降低用户体验。因此，对标签列表进行分页管理，按需加载，显得尤为重要。

认识AnQiCMS的标签机制：tagList 与 tagDataList

在AnQiCMS中，我们主要通过两种模板标签来处理标签相关的数据：

  1. tagList 标签：这个标签主要用于获取网站中的标签列表本身。你可以用它来展示所有热门标签、最新标签，或者某个特定文档关联的标签。它返回的是一个包含所有标签信息的数组。
  2. tagDataList 标签：顾名思义，这个标签用于获取某个特定标签下的文档列表。当你点击一个标签，进入到该标签详情页时，通常会使用 tagDataList 来展示与该标签关联的所有文章或产品。它返回的是与特定标签相关的文档（Archive）信息数组。

理解这两者之间的区别，是实现标签列表分页的关键。

实现标签列表分页的核心：limit 参数与 pagination 标签

要在AnQiCMS中实现标签列表的分页显示，我们主要依赖于两个核心参数和一个关键标签：

  • limit 参数：它定义了每页或每次调用需要显示的数据数量。例如，limit="10" 意味着每页显示10条数据。
  • type="page" 参数：这是开启分页功能的“开关”。当你将 type 设置为 "page" 时，AnQiCMS就知道你需要进行分页处理，并会为该列表生成相应的分页信息。
  • pagination 标签：这个标签是AnQiCMS专为分页设计，它能够根据列表的总数据量和每页显示数量，自动生成“首页”、“上一页”、“下一页”以及具体的页码链接。

接下来，我们将分两种场景，详细说明如何运用这些功能。

场景一：tagList 标签的分页显示

假设你希望在一个专门的“标签云”或“热门标签”页面（通常是 tag/index.html 模板文件）上，分页展示网站所有的标签，而不是全部一次性加载。

1. 使用 tagList 标签获取分页的标签数据：

首先，在你的模板文件（例如 tag/index.html）中，使用 tagList 标签来获取标签数据，并指定 type="page" 和 limit 参数。

{# 在 tag/index.html 模板中，用于分页显示网站所有标签 #}
{% tagList tags with type="page" limit="20" %}
    <div class="tag-list-container">
        {% for item in tags %}
        <a href="{{ item.Link }}" title="{{ item.Title }} ({{ item.ArchiveCount }}篇文章)" class="tag-item">
            {{ item.Title }}
        </a>
        {% empty %}
        <p>抱歉，目前没有可显示的标签。</p>
        {% endfor %}
    </div>
{% endtagList %}

在上述代码中：

  • 我们定义了一个名为 tags 的变量来接收 tagList 返回的标签数据。
  • type="page" 明确告诉系统需要进行分页。
  • limit="20" 则设定每页显示20个标签。
  • {% for item in tags %} 循环遍历获取到的标签数据。
  • item.Link 和 item.Title 分别用于显示标签的链接和名称。
  • item.ArchiveCount（如果文档支持此字段）可以显示该标签下有多少篇文章，增加标签的参考价值。

重要提示： 根据AnQiCMS的文档约定，tagList 标签只有在 tag/index.html 模板中，其 type="page" 参数才能生效并生成分页。在其他模板中使用 type="page" 可能不会产生分页效果，或仅返回 limit 限制的非分页列表。

2. 结合 pagination 标签渲染分页导航：

获取到分页数据后，接下来需要显示用户可以点击跳转的页码。这正是 pagination 标签的用武之地。

{# 紧接着上面的 tagList 标签之后，用于显示分页导航 #}
<div class="pagination-container">
    {% pagination pages with show="5" %}
        <ul class="pagination">
            {# 首页链接 #}
            {% if pages.FirstPage %}
            <li class="page-item {% if pages.FirstPage.IsCurrent %}active{% endif %}">
                <a class="page-link" href="{{ pages.FirstPage.Link }}">{{ pages.FirstPage.Name }}</a>
            </li>
            {% endif %}

            {# 上一页链接 #}
            {% if pages.PrevPage %}
            <li class="page-item">
                <a class="page-link" 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 class="page-link" href="{{ pageItem.Link }}">{{ pageItem.Name }}</a>
            </li>
            {% endfor %}

            {# 下一页链接 #}
            {% if pages.NextPage %}
            <li class="page-item">
                <a class="page-link" href="{{ pages.NextPage.Link }}">{{ pages.NextPage.Name }}</a>
            </li>
            {% endif %}

            {# 尾页链接 #}
            {% if pages.LastPage %}
            <li class="page-item {% if pages.LastPage.IsCurrent %}active{% endif %}">
                <a class="page-link" href="{{ pages.LastPage.Link }}">{{ pages.LastPage.Name }}</a>
            </li>
            {% endif %}
        </ul>
        <div class="page-info">
            总计 {{ pages.TotalItems }} 个标签，共 {{ pages.TotalPages }} 页，当前第 {{ pages.CurrentPage }} 页。
        </div>
    {% endpagination %}
</div>

这里：

  • 我们定义了 pages 变量来接收 pagination 标签生成的分页对象。
  • show="5" 控制在