您好！作为一名资深安企CMS网站运营者，我非常理解高质量内容和用户体验的重要性。分页导航是内容型网站不可或缺的一部分，它直接影响用户浏览体验和内容的可发现性。在AnQiCMS中，生成带有页码数量控制的分页导航是一个直观且功能强大的过程。
下面，我将详细阐述如何在AnQiCMS模板中实现这一功能。
在AnQiCMS模板中生成带有页码数量控制的分页导航
在内容管理系统中，有效的分页导航不仅能帮助用户轻松浏览大量内容，也是提升网站专业度和用户体验的关键。AnQiCMS作为一个高效、灵活的内容管理系统，提供了便捷的模板标签来构建这种导航，并允许您精确控制可见的页码数量。
启用内容列表的分页模式
要构建分页导航，首先需要确保您的内容列表标签处于分页模式。AnQiCMS提供了 archiveList（文档列表）、tagDataList（标签文档列表）和 commentList（评论列表）等标签，它们都支持生成分页数据。在使用这些标签时，您需要明确指定 type="page" 参数，并设置 limit 参数来定义每页显示的项目数量。
例如，如果您想在文章列表页展示每页10篇文章并启用分页，可以这样使用 archiveList 标签：
{% archiveList archives with type="page" limit="10" %}
{# 在这里循环输出每页的文章内容 #}
{% for item in archives %}
<a href="{{ item.Link }}">{{ item.Title }}</a>
{# 更多文章详情... #}
{% endfor %}
{% endarchiveList %}
此处的 archives 变量将包含当前页的文章数据。更重要的是，当 type="page" 被设置后，系统会自动准备好用于分页导航的数据，这些数据随后会被 pagination 标签所利用。
引入分页导航标签并控制页码数量
在您的内容列表标签之后，您可以引入 pagination 标签来渲染分页导航。AnQiCMS的 pagination 标签通过 show 参数，让您能够精确控制导航中显示的页码数量，从而保持界面的整洁和用户体验的优化。
show 参数的值指定了在当前页码前后总共显示多少个页码链接。例如，show="5" 会确保分页导航中最多显示5个页码。
以下是 pagination 标签的基本结构，以及如何使用 show 参数：
<div class="pagination">
{% pagination pages with show="5" %}
{# 分页导航的具体HTML结构将在这里构建 #}
{% endpagination %}
</div>
在这个例子中，pages 是 pagination 标签自动提供的一个变量，包含了构建完整分页导航所需的所有数据，例如总页数、当前页、首页链接、上一页链接、下一页链接、末页链接以及中间页码列表等。
构建分页导航的HTML结构
pages 变量中包含了多个有用的字段，您可以利用这些字段来构建丰富的分页导航。这些字段包括：
TotalItems: 总内容条数。TotalPages: 总页码数。CurrentPage: 当前页码。FirstPage: 首页对象（包含Name和Link）。LastPage: 末页对象（包含Name和Link）。PrevPage: 上一页对象（包含Name和Link）。NextPage: 下一页对象（包含Name和Link）。Pages: 一个数组，包含了中间页码的对象（每个对象包含Name、Link和IsCurrent）。
结合这些字段，您可以灵活地创建分页导航，并根据 IsCurrent 字段为当前页码添加样式，突出显示。
这是一个完整的示例，展示了如何结合 archiveList 和 pagination 标签，以及如何利用 show 参数来控制页码数量：
{# 首先使用 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>
</div>
{% empty %}
<p>该列表没有任何内容。</p>
{% endfor %}
</div>
{# 接着使用 pagination 标签生成分页导航，并控制页码显示数量 #}
<div class="pagination-nav">
{% 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 %}
{# 中间页码链接，受 show="5" 参数控制 #}
{% 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>
{% endarchiveList %}
通过以上步骤，您就可以在AnQiCMS模板中生成一个功能完善且页码数量可控的分页导航。这不仅能提升您网站的用户体验，也能让您的内容管理更加高效和专业。
常见问题解答 (FAQ)
Q: 为什么我在模板中添加了 pagination 标签，但分页导航没有显示？
A: pagination 标签需要特定的内容列表标签（如 archiveList、tagDataList 或 commentList）来为其提供分页数据。请务必检查您的内容列表标签是否设置了 type="page" 参数，并且 limit 参数也已正确配置。如果 limit 参数设置得过大导致所有内容都在一页显示，或者内容总数未超过 limit 设定的数量，也可能不会生成分页。
Q: 如何调整分页导航中显示的页码数量？
A: pagination 标签提供了一个 show 参数，用于控制在分页导航中最多显示多少个页码链接。例如，如果您希望在当前页码周围显示最多5个页码，可以设置 {% pagination pages with show="5" %}。系统会自动根据总页数和当前页码动态调整显示的页码范围。
Q: 我想在分页导航中只显示“上一页”和“下一页”，而隐藏具体的页码数字，这在AnQiCMS中如何实现？
A: 您可以通过灵活运用 pagination 标签内部的逻辑判断来实现这一需求。在 pagination 标签块内，您可以有选择性地只渲染 pages.PrevPage 和 pages.NextPage 的链接，同时省略循环 pages.Pages 数组来隐藏具体的页码数字。例如，您可以删除或注释掉示例代码中 {% for item in pages.Pages %} 到 {% endfor %} 之间的部分。