对于任何一个承载着大量内容的网站来说，如何高效、友好地展示这些内容，无疑是运营成功的关键之一。当文章、产品、标签页等内容数量庞大时，将它们全部堆砌在一个页面上显然不现实，不仅加载速度慢，用户也难以找到所需信息。这时，分页功能就显得尤为重要。

在AnQiCMS中，实现分页功能是相当直观且灵活的。它将内容列表的获取与分页导航的展示巧妙地结合起来，让网站内容的组织和呈现既美观又高效。

核心理念：列表与分页的珠联璧合

在AnQiCMS中，分页功能并非孤立存在，它与内容列表的调用紧密相连。这意味着，您首先需要通过相应的内容列表标签来获取需要分页显示的数据。以最常用的文章列表为例，我们通常会用到archiveList标签。

当您希望archiveList标签返回的数据是可分页的，而不是一次性全部显示或只显示固定数量时，只需在标签中设定type="page"参数，并指定每页显示的数量limit。例如，如果您想在页面上展示文章列表，并且每页显示10篇文章，可以这样编写代码：

{% archiveList archives with type="page" limit="10" %}
    {# 这里是您的文章列表循环代码 #}
    {% for item in archives %}
        <div class="article-item">
            <h3><a href="{{item.Link}}">{{item.Title}}</a></h3>
            <p>{{item.Description}}</p>
            <span>发布日期: {{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
        </div>
    {% empty %}
        <p>暂时没有文章内容。</p>
    {% endfor %}
{% endarchiveList %}

这段代码会告诉AnQiCMS，请获取文章列表数据，但不是一次性全部给出，而是按页面分批提供，每页最多10条。通过archives这个变量，您可以像往常一样循环遍历当前页的文章。

构建分页导航：pagination 标签的魔法

仅仅获取了可分页的文章列表还不够，用户还需要在页面上看到切换页码的导航按钮。真正负责生成页面切换按钮和链接的，是功能强大的pagination标签。

pagination标签通常紧随在其对应的列表标签之后。它会自动读取当前页面的分页信息（例如总页数、当前页码、首页链接、上一页链接等），然后根据您的配置来渲染出漂亮的分页导航。

这个标签最常用的一个参数是show，它决定了在分页导航中最多显示多少个页码按钮。例如，show="5"表示在当前页码前后会显示5个页码。

在使用pagination标签时，它会将所有的分页信息封装在一个名为pages的变量中，您可以通过这个变量访问到所有与分页相关的数据，例如：

  • pages.TotalItems：内容总条数。
  • pages.TotalPages：总页码数。
  • pages.CurrentPage：当前所在页码。
  • pages.FirstPage：首页对象，包含Link（链接）和Name（名称），以及IsCurrent（是否当前页）。
  • pages.LastPage：末页对象，结构与首页对象类似。
  • pages.PrevPage：上一页对象，结构与首页对象类似。
  • pages.NextPage：下一页对象，结构与首页对象类似。
  • pages.Pages：一个包含所有中间页码（通常是当前页码周围的几个页码）的对象数组，每个对象同样包含Link、Name和IsCurrent。

您可以利用这些信息，高度定制您的分页样式。

实战演练：一步步实现分页

现在，让我们把文章列表和分页导航结合起来，看看完整的分页实现代码大致是什么样子：

{# 1. 使用 archiveList 标签获取可分页的文章数据 #}
{% archiveList archives with type="page" limit="10" %}
    <div class="article-list">
        {% for item in archives %}
            <div class="article-item">
                <h3><a href="{{item.Link}}">{{item.Title}}</a></h3>
                <p>{{item.Description}}</p>
                <span>发布日期: {{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
                <span>浏览量: {{item.Views}}</span>
            </div>
        {% empty %}
            <p>暂时没有文章内容。</p>
        {% endfor %}
    </div>
{% endarchiveList %}

{# 2. 使用 pagination 标签生成分页导航 #}
<div class="pagination-nav">
    {% pagination pages with show="5" %}
    <ul>
        {# 首页链接，如果当前是首页则添加 active 样式 #}
        <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 item in pages.Pages %}
            <li class="page-item {% if item.IsCurrent %}active{% endif %}">
                <a href="{{item.Link}}">{{item.Name}}</a>
            </li>
        {% endfor %}

        {# 下一页链接，只有当存在下一页时才显示 #}
        {% if pages.NextPage %}
            <li class="page-item">
                <a href="{{pages.NextPage.Link}}">{{pages.NextPage.Name}}</a>
            </li>
        {% endif %}

        {# 末页链接，如果当前是末页则添加 active 样式 #}
        <li class="page-item {% if pages.LastPage.IsCurrent %}active{% endif %}">
            <a href="{{pages.LastPage.Link}}">{{pages.LastPage.Name}}</a>
        </li>
    </ul>
    <p class="page-info">
        共 {{pages.TotalItems}} 条内容，当前第 {{pages.CurrentPage}} / {{pages.TotalPages}} 页
    </p>
    {% endpagination %}
</div>

在这段代码中，archiveList负责内容的筛选和分批，pagination则负责展示页码、首页、末页、上一页、下一页等导航元素。通过判断IsCurrent属性，您可以轻松为当前页码添加高亮样式，提升用户体验。

不仅仅是文章列表：更多场景的分页应用

AnQiCMS的分页逻辑是统一且灵活的。除了文章列表，您在其他需要批量展示内容的场景，例如产品列表（如果内容模型中定义了产品）、标签文档列表、甚至是评论列表，都可以采用类似的type="page"参数与pagination标签的组合来实现分页。

例如，获取某个Tag下的文档列表并分页，可以使用tagDataList标签：

{% tagDataList archives with type="page" limit="15" %}
    {# 标签下的文档列表循环 #}
    ...
{% endtagDataList %}
{% pagination pages with show="7" %}
    {# 分页导航 #}
    ...
{% endpagination %}

这种一致性使得模板开发和维护变得更加简单，您只需掌握一套分页模式，就能应对AnQiCMS中多样化的内容分页需求。

总结

AnQiCMS在分页功能的实现上，充分考虑了便捷性与扩展性。通过简单地在内容列表标签中设置type="page"和limit参数，并结合功能强大的pagination标签，您就能轻松为网站内容添加专业而流畅的分页导航。这不仅提升了用户浏览体验，也有助于网站内容的结构化和搜索引擎优化，让您的网站在信息洪流中脱颖而出。

常见问题 (FAQ)

1. 如何修改每页显示的文章/产品数量？

您可以通过在内容列表标签（如archiveList、tagDataList）中调整limit参数的值来修改每页显示的数量。例如，将limit="10"改为limit="20"，即可让每页显示20条内容。

2. 分页链接的URL结构可以自定义吗？例如将/list-1.html?page=2改为/list-1_2.html？

是的，AnQiCMS提供了强大的伪静态规则管理功能。您可以在后台的“功能管理”菜单下找到“伪静态规则”，在这里选择或自定义更符合您需求的URL结构，包括将分页参数整合到URL路径中。例如，在自定义规则中，分页页码 {page} 可以放在小括号内，如： (-{page})，这允许将页码以 /list-1-2.html 这样的形式展示。

3. 除了文章和产品，还有哪些类型的内容支持分页？

AnQiCMS的分页功能是通用的。除了常见的文章（archiveList）和自定义内容模型（如产品），它还支持标签下的文档列表（tagDataList）和网站内容评论列表（commentList）的分页显示。只要相应的内容列表标签支持type="page"参数，您就可以配合pagination标签来实现分页效果。