作为一名资深的网站运营专家，我深知一套流畅、信息完整的分页导航对于用户体验和搜索引擎优化（SEO）的重要性。安企CMS（AnQiCMS）以其基于Go语言的高性能架构、灵活的模板引擎以及对SEO友好的设计理念，为我们提供了强大的内容管理能力。今天，我们就来深入探讨如何在AnQiCMS的分页导航中，巧妙地显示诸如“共X页”和“当前第Y页”这类关键信息，让网站的内容呈现更加专业和智能。
分页导航的核心：理解AnQiCMS的pagination标签
在AnQiCMS中，实现分页功能并展示详细的页码信息，其核心在于灵活运用模板中的pagination标签。这个标签专门设计用于处理各种列表内容（如文章、产品等）的分页逻辑，并提供了丰富的页码信息供我们调用。
要使用pagination标签，首先确保你的内容列表标签（如archiveList、tagDataList或commentList）的type参数被设置为"page"。这将告诉系统，你需要获取分页数据，而不仅仅是简单的内容列表。例如，当你获取文章列表时，通常会这样配置：
{% 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>
</div>
{% empty %}
<p>暂时没有文章内容。</p>
{% endfor %}
{% endarchiveList %}
在上述代码中，archives变量将承载当前页面的文档数据。而分页所需的所有元信息，则由系统自动处理并准备好，供pagination标签使用。接下来，我们就可以利用这些由系统生成的“分页对象”来构建完整的导航信息。
关键分页信息概览
当pagination标签被调用时，它会接收到一个包含所有分页细节的pages（或其他你自定义的变量名）对象。这个对象内部包含了许多实用的字段，其中与我们今天主题最相关的就是：
TotalItems：总共的内容条数。TotalPages：总页码数，即“共X页”中的X。CurrentPage：当前所在的页码，即“当前第Y页”中的Y。
此外，pages对象还提供了FirstPage（首页）、LastPage（末页）、PrevPage（上一页）、NextPage（下一页）以及一个包含中间页码链接数组的Pages等信息，这些都是构建完整分页导航不可或缺的部分。
轻松构建“共X页”与“当前第Y页”的显示
现在，让我们通过一个实际的模板代码片段，来展示如何在分页导航中加入这些关键信息。
在你的列表模板文件（例如article/list.html或tag/list.html）中，紧接着archiveList（或其他列表标签）之后，你可以这样构建你的分页区域：
<div class="pagination-wrapper">
{% pagination pages with show="5" %}
<ul class="pagination">
{# 显示总页数和当前页信息 #}
<li class="pagination-info">
共 <span>{{ pages.TotalPages }}</span> 页，当前第 <span>{{ pages.CurrentPage }}</span> 页
</li>
{# 首页链接 #}
{% if pages.FirstPage %}
<li class="page-item {% if pages.FirstPage.IsCurrent %}active{% endif %}">
<a href="{{ pages.FirstPage.Link }}">{{ pages.FirstPage.Name }}</a>
</li>
{% endif %}
{# 上一页链接 #}
{% 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 %}
{# 末页链接 #}
{% if pages.LastPage %}
<li class="page-item {% if pages.LastPage.IsCurrent %}active{% endif %}">
<a href="{{ pages.LastPage.Link }}">{{ pages.LastPage.Name }}</a>
</li>
{% endif %}
</ul>
{% endpagination %}
</div>
在这段代码中：
- 我们使用
{% pagination pages with show="5" %}标签来包裹整个分页导航区域。show="5"参数控制着中间页码最多显示5个，你可以根据设计需求调整这个数字。 - 最重要的是，我们通过
{{ pages.TotalPages }}和{{ pages.CurrentPage }}这两个简单的变量引用，直接在pagination-info这个<li>元素中展示了“共X页”和“当前第Y页”的信息。 - 通过一系列的
{% if %}判断，我们确保只有当存在“首页”、“上一页”、“下一页”和“末页”时，对应的链接才会显示，这让分页导航更加智能，避免了不必要的空链接。 {% for item in pages.Pages %}循环则负责渲染中间的页码链接，item.Name是页码数字，item.Link是对应的页码URL，item.IsCurrent则可以用来为当前页添加高亮样式。
这样一来，你的分页导航不仅功能完善，还能清晰地告知用户当前内容的总量与位置，大大提升了网站的可用性和用户体验。
提升用户体验的额外思考
在设计分页导航时，除了功能实现，美观性和用户体验同样不可忽视。你可以通过自定义CSS样式，让分页导航与网站整体风格保持一致。AnQiCMS强大的模板定制能力，让这一切变得轻而易举。
AnQiCMS在伪静态规则方面的强大支持，也意味着你的分页链接将是清晰、有规律且对搜索引擎友好的，例如yourdomain.com/category/list-1.html、yourdomain.com/category/list-2.html等，这对于内容的抓取和收录非常有益。
用户友好的分页设计不仅能提升网站的专业度，也能有效引导访问者浏览更多内容，增加页面停留时间，从而间接优化网站的整体表现。
结语
通过AnQiCMS灵活的模板标签体系，特别是pagination标签的强大功能，我们能够轻松实现内容列表的分页显示，并精准地呈现“共X页”与“当前第Y页”等关键信息。这种高度定制化的能力，正是AnQiCMS作为企业级内容管理系统所能带来的核心价值之一，它让内容运营者能够专注于内容的创造与传播，而无需被复杂的底层技术所困扰。
常见问题 (FAQ)
Q1: archiveList 标签的 type 参数有什么作用？如果我不需要分页，应该如何设置？
A1: archiveList 标签的 type 参数用于指定列表的显示类型。当设置为 type="page" 时，它会为内容列表生成完整的页码信息，供pagination标签使用。如果你的内容列表不需要分页功能，而只是想简单地列出一定数量的内容，那么可以将type参数设置为type="list"，此时通常会配合limit参数来控制显示条数，例如limit="10"。在这种模式下，pagination标签将无法获取到分页数据。
Q2: 除了“共X页”和“当前第Y页”，我还能在分页导航中显示哪些额外信息？
A2: pagination标签的pages对象还提供了TotalItems字段，表示分页内容的