作为一名深谙AnQiCMS运作之道的网站运营人员，我深知内容呈现的精妙之处在于如何高效且优雅地服务用户。对于包含大量内容的文档列表页面，合理的分页机制不仅能提升用户体验，还能优化网站性能。在AnQiCMS中，pagination标签正是实现这一目标的核心工具，它允许我们灵活地控制文档列表的分页显示及其样式。
理解AnQiCMS中的分页机制
AnQiCMS将内容列表的分页逻辑与内容展示本身解耦，这意味着您首先需要使用archiveList标签以type="page"模式获取可分页的文档数据。一旦archiveList生成了带有分页信息的数据集（通常我们会将其命名为archives，并伴随一个pages变量存储分页元数据），pagination标签便能登场，负责解析这些分页元数据，并将其渲染为用户可见的导航元素。这种分离的设计理念，赋予了模板开发者极大的自由度，可以在不影响核心数据逻辑的前提下，对分页的视觉呈现进行深度定制。
pagination标签的基本使用方式
pagination标签的使用非常直观，它总是与一个存储分页信息的变量配合，并以{% pagination pages with show="5" %}...{% endpagination %}的结构出现。这里的pages便是由archiveList标签在type="page"模式下自动提供的分页对象。show参数是控制页面显示页码数量的关键，例如，show="5"表示在当前页码前后最多显示5个数字页码链接，以保持分页导航的简洁性。
除了基本的show参数外，pagination标签还提供了一个prefix参数，这通常是一个高级功能。它允许您重定义分页链接的URL模式，例如prefix="?page={page}"。在大多数标准应用场景下，AnQiCMS会自动处理URL的构建，因此prefix参数通常无需手动设置。
pagination标签提供的核心字段
pagination标签内部封装了一个全面的分页数据对象，通过这些字段，我们可以精确地构建分页导航。这些字段包括：
TotalItems: 表示文档列表的总条目数，让用户了解内容总量。TotalPages: 显示文档列表的总页数，告知用户内容分布在多少个页面中。CurrentPage: 标记当前用户正在浏览的页码，这是用户定位自身位置的关键信息。FirstPage: 一个对象，包含指向第一页的链接和名称，方便用户快速返回起始页。LastPage: 一个对象，包含指向最后一页的链接和名称，便于用户跳转至内容末尾。PrevPage: 一个对象，包含指向上一页的链接和名称，实现顺序浏览。NextPage: 一个对象，包含指向下一页的链接和名称，用于继续浏览下一页内容。Pages: 这是一个数组对象，包含了中间的数字页码链接，这是构建页码列表的核心数据。
特别地，Pages数组中的每个元素（我们称之为pageItem）也拥有自己的字段，包括Name（页码的显示名称，如“1”、“2”）、Link（指向该页的URL）以及IsCurrent（一个布尔值，指示该页码是否为当前活动页）。
如何构建灵活的分页样式
凭借pagination标签提供的丰富字段，我们可以构建出高度定制化的分页导航。以下是一个典型的AnQiCMS分页代码示例，展示了如何结合这些字段实现功能完备且样式可控的分页：
首先，在您的模板中，确保您已经使用archiveList标签以type="page"模式获取了文档列表数据：
{# page 分页列表展示 #}
<div>
{% archiveList archives with type="page" limit="10" %}
{% for item in archives %}
<li>
<a href="{{item.Link}}">
<h5>{{item.Title}}</h5>
<div>{{item.Description}}</div>
<div>
<span>{% categoryDetail with name="Title" id=item.CategoryId %}</span>
<span>{{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
<span>{{item.Views}} 阅读</span>
</div>
</a>
{% if item.Thumb %}
<a href="{{item.Link}}">
<img alt="{{item.Title}}" src="{{item.Thumb}}">
</a>
{% endif %}
</li>
{% empty %}
<li>
该列表没有任何内容
</li>
{% endfor %}
{% endarchiveList %}
{# 分页代码 #}
<div class="pagination-container">
{% pagination pages with show="5" %}
<ul class="pagination">
{# 显示总数、总页码、当前页等信息 #}
<li class="info">总数：{{pages.TotalItems}}条，总共：{{pages.TotalPages}}页，当前第{{pages.CurrentPage}}页</li>
{# 首页链接，根据IsCurrent状态添加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 %}
{# 中间数字页码列表，遍历Pages数组 #}
{% 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 %}
{# 末页链接，根据IsCurrent状态添加active样式 #}
<li class="page-item {% if pages.LastPage.IsCurrent %}active{% endif %}">
<a href="{{pages.LastPage.Link}}">{{pages.LastPage.Name}}</a>
</li>
</ul>
{% endpagination %}
</div>
</div>
在这个示例中，我们首先通过div和ul标签为分页区域提供结构，方便后续通过CSS进行样式控制。每个分页链接都被包裹在li标签中，并添加了page-item类。我们巧妙地利用IsCurrent属性为当前页码动态添加了active类，这使得我们可以通过CSS规则（例如.pagination .active a { background-color: #007bff; color: white; }）来突出显示当前页，提升视觉反馈。
此外，对于“上一页”和“下一页”的链接，我们使用{% if pages.PrevPage %}和{% if pages.NextPage %}进行条件判断，确保这些导航元素只在逻辑上存在时才被渲染出来，避免出现无效链接，进一步优化了用户体验。这种精细的控制，让您可以根据网站的设计风格，自由地调整分页的布局、颜色、字体等一切视觉元素。
结语
pagination标签作为AnQiCMS内容列表分页的核心，其设计哲学是提供强大的数据支撑与极高的模板渲染自由度。通过灵活运用其参数和内置字段，并结合CSS进行样式控制，您将能够为网站访问者提供既高效又美观的浏览体验，让内容列表的呈现更上一层楼。
常见问题解答
Q1: 为什么我的页面没有显示分页？
A: 首先，请检查您的archiveList标签是否设置了type="page"，因为pagination标签仅在archiveList以分页模式获取数据时才能正常工作。其次，请确保您的内容列表确实包含多于一页的数据，如果内容太少不足以分页，那么分页导航自然不会显示。最后，请检查模板中pagination标签的语法是否正确，特别是变量名pages是否与archiveList返回的分页数据变量一致。
Q2: 如何改变分页中数字页码的显示数量？
A: 您可以通过pagination标签的show参数来控制显示的数字页码数量。例如，{% pagination pages with show="7" %}将会在当前页码前后显示更多页码链接，总计最多7个数字页码。您可以根据页面的宽度和设计需求，调整这个参数以达到**视觉效果。
Q3: 分页是否可以与搜索结果或筛选条件结合使用？
A: 当然可以。AnQiCMS的pagination标签与archiveList标签紧密集成，而archiveList本身支持q（搜索关键词）和自定义筛选参数。这意味着，当用户在搜索结果页或应用了筛选条件的列表页进行分页时，pagination标签会自动生成包含这些搜索和筛选条件的新分页链接，确保用户在不同页码间切换时，搜索或筛选条件得以保留，从而提供无缝的用户体验。