AnQiCMS 文档列表分页与自定义页码数量：让你的内容管理更高效

想象一下，当您的网站内容日益丰富，成千上万篇文章、产品或新闻列表整齐排列时，如果不能有效地组织和展示，用户可能会感到无从下手。良好的分页机制不仅能提升用户体验，帮助访客快速找到所需信息，更是SEO优化的重要一环。AnQiCMS，作为一款高效的内容管理系统，深知这一需求的重要性，因此提供了非常灵活且易于实现的文档列表分页功能，并支持自定义每页显示的条目数量和分页导航的样式，让您的内容管理工作如虎添翼。

轻松掌握分页的核心：archiveList 与 pagination 标签

在AnQiCMS中实现文档列表的分页显示，主要依赖于两个强大的模板标签：archiveList 和 pagination。我们可以将archiveList理解为内容的数据抓取能手，它负责从数据库中按需获取文档数据；而pagination则是页面导航的建造师，它根据archiveList提供的数据，构建出您网站下方可见的分页链接条。

要实现分页，首先我们需要明确两点：

  1. 每页显示多少条文档？ 这由archiveList标签的limit参数控制。
  2. 分页导航条上最多显示多少个页码？ 这由pagination标签的show参数控制。

了解了这两个核心概念后，我们就可以着手在AnQiCMS的模板中实现文档列表的分页了。

实现文档列表分页的步骤

通常，我们会在{模型table}/list.html（例如article/list.html或product/list.html）、search/index.html或tag/list.html这样的列表页模板中进行分页逻辑的设置。

第一步：使用 archiveList 获取分页数据并定义每页数量

首先，您需要在模板中使用archiveList标签来获取文档数据。这里的关键在于设置type="page"参数，这告诉系统您希望数据以分页形式返回，而不是简单的列表。同时，通过limit参数，您可以轻松控制每页显示多少条文档。例如，如果您希望每页显示10条文档，可以这样设置：

{% archiveList archives with type="page" limit="10" %}
    {% for item in archives %}
        <!-- 在这里展示每篇文档的标题、链接、简介等信息 -->
        <h3><a href="{{item.Link}}">{{item.Title}}</a></h3>
        <p>{{item.Description}}</p>
        <!-- 更多文档字段 -->
    {% empty %}
        <p>当前分类或搜索条件下没有找到任何文档。</p>
    {% endfor %}
{% endarchiveList %}

在这段代码中，archives是一个包含当前页所有文档的数组对象。您可以使用{% for item in archives %}循环来遍历并展示每一篇文档的详细信息。limit="10"明确告诉AnQiCMS，每翻一页，只显示10条文档。

archiveList标签还支持其他参数来精细控制数据范围，比如moduleId（按模型ID筛选）、categoryId（按分类ID筛选）、order（排序方式，如order="views desc"按浏览量降序）以及q（搜索关键词）等，让您的内容筛选更加灵活。

第二步：使用 pagination 构建分页导航并自定义页码数量

获取了分页数据后，接下来就需要构建页面下方的分页导航条，让用户能够点击翻页。这需要用到pagination标签。这个标签会自动根据archiveList获取到的数据，计算出总页数、当前页、首页、末页、上一页和下一页等信息，并生成相应的导航链接。

最方便的是，您可以通过show参数来定义分页导航条上最多显示多少个页码链接。例如，设置show="5"，就会显示当前页附近最多5个页码链接，这有助于保持分页导航的简洁性，特别是在总页数非常多的情况下。

以下是一个常见的分页导航示例：

<div class="pagination">
    {% pagination pages with show="5" %}
    <ul>
        <!-- 显示总条数和总页数，帮助用户了解整体内容量 -->
        <li>总数：{{pages.TotalItems}}条，总共：{{pages.TotalPages}}页，当前第{{pages.CurrentPage}}页</li>

        <!-- 首页链接 -->
        <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 %}

        <!-- 末页链接 -->
        <li class="page-item {% if pages.LastPage.IsCurrent %}active{% endif %}">
            <a href="{{pages.LastPage.Link}}">{{pages.LastPage.Name}}</a>
        </li>
    </ul>
    {% endpagination %}
</div>

在这段代码中，pages是pagination标签提供的分页信息对象。它包含了TotalItems（总条目数）、TotalPages（总页数）、CurrentPage（当前页码）以及FirstPage、PrevPage、NextPage、LastPage等页面对象，每个页面对象又包含Name（链接文本）、Link（链接URL）和IsCurrent（是否为当前页）等属性。通过循环pages.Pages，您可以展示中间部分的页码链接，并利用{% if item.IsCurrent %}判断当前页，为其添加不同的样式，以提供更好的视觉反馈。

灵活运用与高级技巧

AnQiCMS的分页功能并非孤立存在，它能与网站的搜索和筛选功能无缝结合。当用户在搜索框中输入关键词，或者通过筛选条件过滤内容时，archiveList标签会自动识别URL中的q（搜索关键词）或其他自定义筛选参数，并在分页时保持这些条件，确保用户在翻页时始终看到符合其筛选条件的内容。

如果您管理着多个站点，并希望在一个站点中调用另一个站点的内容列表并进行分页，archiveList标签的siteId参数就能派上用场了。通过指定siteId，您可以跨站点调用内容，为多站点运营提供了极大的便利。

AnQiCMS在文档列表分页的实现上，充分考虑到了实用性和灵活性。通过简单的标签组合，就能满足从基本分页到复杂内容展示的需求。它不仅帮助我们高效地组织和呈现海量内容，还通过清晰的模板语法，让二次开发和定制变得轻松愉悦。

常见问题解答 (FAQ)

1. 为什么我设置了limit参数，但是分页导航条上显示的页码数量没有变化？

limit参数控制的是每页显示多少条文档（即每页内容数量），而pagination标签内的show参数控制的才是分页导航条上最多显示多少个页码链接。这两个参数是各自独立的，共同协作来定义完整的用户分页体验。如果您希望分页导航条更简洁，比如只显示当前页前后几页，就需要调整show参数的值。

2. 我可以在同一个页面上使用多个分页列表吗？例如，一个页面上方是文章列表，下方是产品列表，两者都带分页？

是的，AnQiCMS支持在同一个页面上实现多个独立的分页列表。关键在于为每个archiveList标签和其对应的pagination标签使用不同的变量名称。例如，您可以将