作为一位深谙安企CMS (AnQiCMS) 运营之道的专家，我深知一套流畅、用户友好的网站体验对于吸引和留住用户至关重要。内容列表的分页功能是任何内容密集型网站的基石，它不仅优化了用户浏览体验，更是搜索引擎优化的重要环节。在AnQiCMS中，通过其强大的模板标签系统，实现文章列表的完整分页功能变得高效且灵活。
文章列表分页功能概述
在AnQiCMS模板中，为文章列表实现完整的分页功能主要依赖于两个核心模板标签的协同工作：archiveList 用于从数据库中获取文章数据，并按页进行划分；pagination 则负责生成和显示页码导航链接，引导用户在不同页面间切换。理解这两个标签的用法和它们之间的数据传递机制，是构建高效分页列表的关键。
分页功能的引入，将长篇累牍的文章列表拆分成可管理的多个页面。这显著提升了页面加载速度，因为浏览器不必一次性加载所有文章数据。同时，它也改善了用户体验，用户可以轻松地找到自己感兴趣的内容，避免了无休止的滚动。对于搜索引擎优化而言，清晰的分页结构有助于爬虫更好地索引网站内容，避免重复内容，并确保每一页的内容都能被发现和收录。
获取文章数据：archiveList 标签的应用
首先，我们需要使用 archiveList 标签来获取文章数据。为了实现分页，该标签必须配置 type="page" 参数。这个参数告诉AnQiCMS系统，我们希望获取的文章数据是为分页而准备的，系统将自动处理当前页码和总页数等信息。
在模板中，archiveList 标签通常会定义一个变量名来存储查询到的文章列表。例如，我们可以将其命名为 archives。limit 参数用于指定每页显示的文章数量，这是控制分页粒度的关键。此外，我们还可以通过 moduleId 和 categoryId 等参数来筛选特定模型或分类下的文章，或者使用 order 参数来定义文章的排序方式（例如按发布时间倒序 id desc 或按浏览量 views desc）。
一个基本的 archiveList 用法如下所示，它将获取指定分类下每页10篇文章的数据：
{% archiveList archives with type="page" categoryId="1" limit="10" order="id desc" %}
{# 循环显示当前页的文章列表 #}
{% for item in archives %}
<li>
<a href="{{item.Link}}">
<h5>{{item.Title}}</h5>
<p>{{item.Description}}</p>
<span>发布时间：{{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
<span>阅读量：{{item.Views}}</span>
</a>
</li>
{% empty %}
<li>暂无相关文章。</li>
{% endfor %}
{% endarchiveList %}
在上述代码中，archives 变量包含了当前页的所有文章数据。通过 for 循环，我们可以遍历并显示这些文章的标题、链接、简介等信息。empty 块则用于在没有文章时显示友好的提示信息。
生成分页导航：pagination 标签的实现
在 archiveList 标签之后，我们需要引入 pagination 标签来生成分页导航。pagination 标签会自动利用 archiveList 生成的分页数据来构建页码链接。它同样会定义一个变量名，通常为 pages，用于存储所有与分页相关的详细信息，如总页数、当前页、首页、上一页、下一页和末页的链接等。
pagination 标签的一个重要参数是 show，它决定了在页码列表中最多显示多少个页码按钮。例如，show="5" 将显示当前页附近最多5个页码，这有助于保持分页导航的简洁性，特别是在文章数量庞大时。
下面是 pagination 标签及其内部结构的典型应用示例：
<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 变量提供了构建完整分页导航所需的一切。pages.FirstPage、pages.PrevPage、pages.Pages（一个包含中间页码的数组）、pages.NextPage 和 pages.LastPage 各自提供了对应的页码名称 (Name)、链接 (Link) 以及是否为当前页 (IsCurrent) 的布尔值，使得我们可以根据需要灵活地渲染分页样式和交互。
整合文章列表与分页功能
为了在AnQiCMS模板中实现文章列表的完整分页功能，我们将 archiveList 和 pagination 标签整合在一个模板文件中。这个模板文件通常会是某个分类的列表页模板，例如 article/list.html 或 product/list.html，这取决于您在后台内容模型和分类设置中所定义的结构。
以下是一个完整的示例，展示了如何在AnQiCMS模板中，为一个ID为1的文章分类实现分页的文章列表：
{# 假设这是 article/list.html 模板文件 #}
{# 获取页面的TDK信息 #}
<title>{% tdk with name="Title" siteName=true %}</title>
<meta name="keywords" content="{% tdk with name="Keywords" %}">
<meta name="description" content="{% tdk with name="Description" %}">
{# 面包屑导航 #}
<div class="breadcrumb">
{% breadcrumb crumbs with index="首页" title=true %}
<ul>
{% for item in crumbs %}
<li><a href="{{item.Link}}">{{item.Name}}</a></li>
{% endfor %}
</ul>
{% endbreadcrumb %}
</div>
<h1>{{ category.Title }}</h1> {# 显示当前分类标题，假设有 category 变量 #}
<div class="article-list-container">
{# 使用 archiveList 标签获取文章列表，并启用分页模式 #}
{% archiveList archives with type="page" categoryId="1" limit="10" order="id desc" %}
<ul class="article-items">
{% for item in archives %}
<li class="article-item">
<a href="{{item.Link}}" title="{{item.Title}}">
<div class="article-thumb">
{% if item.Thumb %}
<img src="{{item.Thumb}}" alt="{{item.Title}}">
{% else %}
<img src="/public/static/images/default-thumb.jpg" alt="默认缩略图">
{% endif %}
</div>
<div class="article-info">
<h2 class="article-title">{{item.Title}}</h2>
<p class="article-description">{{item.Description}}</p>
<div class="article-meta">
<span>发布日期: {{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
<span>阅读量: {{item.Views}}</span>
</div>
</div>
</a>
</li>
{% empty %}
<li class="no-content">当前分类下暂无文章。</li>
{% endfor %}
</ul>
{# 在文章列表下方显示分页导航 #}
<div class="pagination-controls">
{% pagination pages with show="5" %}
<ul class="pagination-list">
<li class="page-item {% if pages.FirstPage.IsCurrent %}active{% endif %}">
<a href="{{pages.FirstPage.Link}}" class="page-link">{{pages.FirstPage.Name}}</a>
</li>
{% if pages.PrevPage %}
<li class="page-item">
<a href="{{pages.PrevPage.Link}}" class="page-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}}" class="page-link">{{pageItem.Name}}</a>
</li>
{% endfor %}
{% if pages.NextPage %}
<li class="page-item">
<a href="{{pages.NextPage.Link}}" class="page-link">{{pages.NextPage.Name}}</a>
</li>
{% endif %}
<li class="page-item {% if pages.LastPage.IsCurrent %}active{% endif %}">
<a href="{{pages.LastPage.Link}}" class="page-link">{{pages.LastPage.Name}}</a>
</li>
</ul>
<div class="pagination-summary">
共 {{pages.TotalItems}} 篇文章，{{pages.TotalPages}} 页，当前第 {{pages.CurrentPage}} 页
</div>
{% endpagination %}
</div>
{% endarchiveList %}
</div>
这段代码首先利用 archiveList 获取当前页的文章，然后通过 for 循环展示它们。紧接着，pagination 标签被用来渲染分页链接。通过 pages 变量的各个属性，我们可以精确控制首页、上一页、具体页码、下一页和末页的显示，并根据 IsCurrent 属性添加 active 类来突出显示当前页。
当用户访问这个页面时，AnQiCMS会根据URL中的页码参数自动处理 archiveList 和 pagination 标签，显示对应页码的文章和更新的分页导航。这种分离内容获取和分页渲染的设计，让模板逻辑清晰，维护便捷。
模板文件的存放位置
根据AnQiCMS的模板约定，列表页的模板文件通常存放在/template/{您的模板目录名}/{模型table}/list.html。例如，如果您的文章模型名为 article，且模板目录是 default，则该文件应命名为 default/article/list.html。此外，AnQiCMS还支持根据分类ID定制模板，例如 default/article/list-{分类ID}.html，以实现更精细的页面设计。
通过上述步骤和示例，您应该能够在AnQiCMS模板中轻松实现文章列表的完整分页功能，从而提供一个更加专业、高效和用户友好的网站体验。
常见问题解答 (FAQ)
1. 为什么我的文章列表显示了文章，但分页导航却不显示？
出现这种情况通常是因为 archiveList 标签的 type 参数未正确设置为 "page"。只有当 archiveList 的 type 为 "page" 时，AnQiCMS系统才会生成必要的分页数据供 pagination 标签使用。请检查您的 archiveList 标签，确保它包含 type="page" 参数。
2. 如何为不同分类的文章列表设置不同的每页显示数量？
您可以通过在每个分类对应的 archiveList 标签中，单独设置 limit 参数的值来实现。例如，在一个分类列表模板中，您可以设置 limit="5"，而在另一个分类列表模板中，您可以设置为 limit="20"。如果您希望某个分类使用完全不同的模板，也可以在后台的分类设置中指定自定义的分类模板。
3. 分页链接的URL结构是如何生成的？我需要手动修改伪静态规则吗？
AnQiCMS的分页链接URL结构是自动生成的，并且与您在后台配置的伪静态规则（如/{module}-{id}.html或/{module}-{filename}(-{page})等）保持一致。通常情况下，您无需手动修改伪静态规则以适应分页功能。只要伪静态规则配置正确，分页链接会自动生成包含页码参数的友好URL。如果您使用了自定义的伪静态规则，确保规则中包含 {page} 参数，以确保分页功能正常工作。