`archiveList`标签在使用`type="page"`模式时，如何与`pagination`标签协同工作实现分页？
在AnQiCMS内容管理系统中，高效地展示大量内容并确保良好的用户体验与搜索引擎友好度是运营成功的关键。而这其中，内容列表的分页显示无疑扮演了核心角色。作为一名资深的网站运营专家，我深知 archiveList 标签与 pagination 标签的巧妙结合，是实现这一目标的强大工具，尤其是在 archiveList 采用 type="page" 模式时。
让我们一起深入探讨这两个标签如何协同工作，为您的AnQiCMS网站构建流畅且易于管理的文章列表。
构建动态内容列表：archiveList 标签的“分页”模式
archiveList 标签是AnQiCMS中用于获取各类文档内容（如文章、产品等）的强大利器。它能根据不同的条件筛选和排序内容，并以列表形式呈现。当我们需要为这些内容列表添加分页功能时，type="page" 模式便闪亮登场。
当您在 archiveList 标签中设置 type="page" 时，它会智能地感知到当前页面的URL中可能包含的分页信息，并据此获取相应页码的内容。此时，limit 参数不再是简单地限制显示的总条数，而是定义了每页显示的内容数量。这就像您告诉系统：“请准备好一个可分页的内容集，每页显示这么多条内容。”
例如，如果您想在文章列表页展示文章，每页十篇，可以这样使用 archiveList：
{% archiveList archives with type="page" moduleId="1" categoryId="1" limit="10" %}
{# 循环输出当前页的文章内容 #}
{% 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>
</a>
</li>
{% empty %}
<li>暂无相关内容。</li>
{% endfor %}
{% endarchiveList %}
在这个示例中，moduleId="1" 指明了要获取的是文章模型的内容，categoryId="1" 则限定了特定的文章分类，而 limit="10" 则决定了每页加载十篇文章。archives 变量现在包含了当前页需要展示的十篇文章数据。然而，仅仅有文章列表是不够的，用户还需要导航到其他页面。这时，pagination 标签就发挥了它的作用。
掌控分页导航：pagination 标签的精妙联动
pagination 标签是 archiveList 在 type="page" 模式下的**搭档。它负责生成页面下方的页码导航，允许用户方便地跳转到不同的内容页。pagination 标签无需您手动传入复杂的页码计算逻辑，它会自动接收并处理 archiveList 在 type="page" 模式下生成的分页上下文数据。
当 archiveList 以 type="page" 模式运行时，它会准备一个名为 pages 的全局或局部变量（通常在 {% archiveList ... %} 之后立即可用），这个 pages 对象包含了所有与分页相关的信息，例如总内容条数 TotalItems、总页数 TotalPages、当前页码 CurrentPage、首页链接 FirstPage、末页链接 LastPage，以及上一页 PrevPage、下一页 NextPage 的详细信息，甚至是一个包含所有可见页码链接的数组 Pages。
pagination 标签的关键参数是 show，它决定了在页码导航中显示多少个连续的页码。例如，show="5" 会显示以当前页为中心的五个页码。
以下是 pagination 标签的典型用法：
<div class="pagination-container">
{% pagination pages with show="5" %}
<ul>
{# 首页链接 #}
<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>
<p>总计：{{pages.TotalItems}}条内容，共{{pages.TotalPages}}页，当前第{{pages.CurrentPage}}页。</p>
{% endpagination %}
</div>
协同工作：内容列表与分页导航的完美融合
将 archiveList 和 pagination 结合起来，便能构建一个完整且功能强大的内容分页列表。通常，您会先使用 archiveList 获取当前页的内容，然后在其下方紧接着使用 pagination 来生成导航链接。
<section class="article-list">
<h3>最新文章</h3>
<ul>
{% archiveList articles with type="page" moduleId="1" limit="10" %}
{% for article in articles %}
<li>
<a href="{{article.Link}}">
<h4>{{article.Title}}</h4>
<p>{{article.Description|truncatechars:100}}</p>
<time>{{stampToDate(article.CreatedTime, "2006年01月02日")}}</time>
</a>
</li>
{% empty %}
<p>抱歉，目前没有找到任何文章。</p>
{% endfor %}
{% endarchiveList %}
</ul>
{# 分页代码紧随其后，使用 archiveList 自动提供的 pages 变量 #}
<nav class="pagination">
{% pagination pages with show="5" %}
<p class="page-info">当前是第 {{pages.CurrentPage}} 页，总共有 {{pages.TotalPages}} 页，共 {{pages.TotalItems}} 条内容。</p>
<ul class="page-numbers">
{% if pages.FirstPage %}
<li {% if pages.FirstPage.IsCurrent %}class="active"{% endif %}><a href="{{pages.FirstPage.Link}}">{{pages.FirstPage.Name}}</a></li>
{% endif %}
{% if pages.PrevPage %}
<li><a href="{{pages.PrevPage.Link}}">{{pages.PrevPage.Name}}</a></li>
{% endif %}
{% for pageItem in pages.Pages %}
<li {% if pageItem.IsCurrent %}class="active"{% endif %}><a href="{{pageItem.Link}}">{{pageItem.Name}}</a></li>
{% endfor %}
{% if pages.NextPage %}
<li><a href="{{pages.NextPage.Link}}">{{pages.NextPage.Name}}</a></li>
{% endif %}
{% if pages.LastPage %}
<li {% if pages.LastPage.IsCurrent %}class="active"{% endif %}><a href="{{pages.LastPage.Link}}">{{pages.LastPage.Name}}</a></li>
{% endif %}
</ul>
{% endpagination %}
</nav>
</section>
在这个完整的代码块中，archiveList 负责获取当前页的文章数据，而 pagination 则利用 archiveList 提供的 pages 变量，生成了一系列方便用户浏览的页码链接。每一个 pageItem.Link 都包含了正确的URL，允许用户点击后跳转到相应的分页内容。这样的设计，不仅让模板代码更加简洁，也极大地提升了内容的可访问性和网站的整体用户体验。
通过这样的配合，AnQiCMS让您能够轻松地管理网站上的大量内容，同时保持网站的响应速度和良好的SEO表现，因为每个分页都有其独特的URL，便于搜索引擎抓取和索引。
常见问题 (FAQ)
Q1: archiveList 标签的 limit 参数在 type="page" 和 type="list" 模式下有何不同？
A1: 这是个非常关键的区别。当 archiveList 使用 type="list" 模式时，limit 参数直接决定了标签将获取并返回的内容总条数，它不会考虑分页，也不会生成分页数据。例如，limit="10" 会简单地获取前10条内容。而当 archiveList 使用 type="page" 模式时，limit 参数则表示每页显示的内容数量。在这种模式下，系统会计算总页数，并根据当前请求的页码，返回该页应显示的内容，同时准备好供 pagination 标签使用的分页上下文数据。简而言之，type="list" 是“取固定数量”，type="page" 是“按页取固定数量”。
Q2: 如果我的内容列表需要支持搜索功能，archiveList 和 pagination 如何配合？
A2: AnQiCMS已经为您考虑到了这一点。当 archiveList 使用 type="page" 模式时，它会自动识别URL中的 q 参数（即搜索关键词）和其他自定义筛选参数。这意味着您只需在搜索表单中将关键词作为 q 参数传递给列表页URL，archiveList 便会根据关键词过滤内容。更棒的是，pagination 标签生成的页码链接也会自动包含这些搜索和筛选参数，确保用户在点击分页时，仍能保持在搜索结果的上下文中。您无需为分页链接手动拼接复杂的URL参数。
Q3: 在使用 archiveList 和 pagination 后，如何确保我的分页内容对SEO友好？
A3: 启用 type="page" 模式和 pagination 标签后，AnQiCMS会为每个分页生成独立的、清晰的URL，这本身就对SEO非常有利。为了进一步优化，您可以确保以下几点：
- TDK 设置：利用
tdk标签，为列表页设置合适的页面标题（Title）、关键词（Keywords）和描述（Description），并可以根据页码动态调整。 - Canonical URL：如果某些分页内容过于相似，或者您担心重复内容问题，可以考虑在
tdk标签中设置CanonicalUrl指向第一页或更具权威性的页面（但请谨慎使用，并非所有分页都需要）。 - Hreflang 标签：如果您的网站支持多语言，确保在
head中使用hreflang标签正确指向不同语言和地区的分页版本，AnQiCMS的languages标签可以帮助您实现。 - 清晰的导航：
pagination标签生成的“上一页”、“下一页”以及数字页码链接，能帮助搜索引擎蜘蛛更好地发现和索引所有分页内容。