使用`categoryList`嵌套`archiveList`时，如何处理`archiveList`的分页问题？
作为一名资深的网站运营专家，我在AnQiCMS的内容管理实践中积累了丰富的经验。我深知，当面对AnQiCMS强大的模板标签体系时，如何巧妙地组合它们以实现预期的内容展示效果，是很多运营者和开发者会遇到的挑战。今天，我们就来深入探讨一个常见而又容易让人困惑的问题：在使用categoryList嵌套archiveList时，如何妥善处理archiveList的分页问题？
嵌套场景下的分页困境：理解核心逻辑
首先，让我们明确一下AnQiCMS中categoryList和archiveList这两个核心标签的功能。categoryList标签用于循环遍历和展示网站的分类信息，例如在首页列出所有产品类别，或在侧边栏显示文章分类树。而archiveList标签则用于获取和展示文档（文章、产品等）列表。当我们需要在一个分类下展示其相关的文档时，自然会将archiveList嵌套在categoryList的循环中。
那么，分页的困挑战在哪里呢？AnQiCMS中的archiveList标签可以通过设置type="page"参数来开启分页功能，并配合pagination标签生成分页链接。然而，这里的关键在于，URL中的分页参数（例如?page=2）通常是针对整个页面主内容区域的单一列表进行控制的。
想象一下，如果你在一个页面上同时展示了多个分类，每个分类下都用一个archiveList来显示其文章。此时，如果每个archiveList都尝试进行“分页”，URL中的?page=X这个参数究竟应该控制哪一个分类的文档列表跳转到第二页呢？这在逻辑上是矛盾且无法统一处理的。AnQiCMS的设计哲学也遵循了这一原则：一个页面通常只存在一个主导的分页列表。
因此，当你尝试在categoryList的循环中为每个嵌套的archiveList都设置type="page"并期望它们各自独立分页时，会发现这种方式并不能实现你可能想象中的“每个分类都有自己的独立分页控件”的效果。
解决方案一：嵌套场景下的“摘要式”展示
在大多数情况下，将archiveList嵌套在categoryList中，是为了在首页、分类概览页或侧边栏等地方，以摘要或精选的形式展示每个分类的少量最新或热门文档。在这种“摘要式”展示场景下，我们通常不需要为每个分类的文档列表提供完整的分页功能。
正确的做法是，让嵌套的archiveList使用type="list"参数并配合limit参数来限制展示的文档数量。这样，每个分类都会显示其最新的几篇文章，而不会出现分页的困扰。
举个例子，假设你希望在首页展示几个主要分类，每个分类下方显示其最新的5篇文章：
{% categoryList categories with moduleId="1" parentId="0" %}
<div class="category-sections">
{% for category in categories %}
<div class="category-card">
<h3><a href="{{ category.Link }}">{{ category.Title }}</a></h3>
<ul>
{# 在分类列表内部，我们通常只展示每个分类的最新几篇文章，而不是分页显示所有文章 #}
{% archiveList archives with type="list" categoryId=category.Id limit="5" order="id desc" %}
{% for article in archives %}
<li>
<a href="{{ article.Link }}">{{ article.Title }}</a>
<span class="publish-date">{{ stampToDate(article.CreatedTime, "2006-01-02") }}</span>
</li>
{% empty %}
<li>该分类暂无文章。</li>
{% endfor %}
{% endarchiveList %}
<a href="{{ category.Link }}" class="more-link">查看更多 {{ category.Title }} 的文章 »</a>
</ul>
</div>
{% endfor %}
</div>
{% endcategoryList %}
在这段代码中，archiveList明确使用了type="list"和limit="5"，确保了每个分类都只显示固定数量的文档。而用户如果想查看某个分类的全部文档并进行分页浏览，则会点击分类标题或“查看更多”链接，跳转到该分类的专属列表页。
解决方案二：专属列表页的“全量式”分页
当用户点击进入一个特定的分类页面时（例如yourdomain.com/category/news），这个页面就是该分类的“专属列表页”。在这种页面上，实现文档的全量分页才是符合逻辑和用户预期的。
在专属列表页的模板中（通常是{模型table}/list.html或{模型table}/list-{分类id}.html），你可以使用archiveList标签并设置type="page"，配合pagination标签来生成分页。AnQiCMS非常智能，它会根据当前页面的URL自动识别当前的分类ID，所以通常你不需要显式地在archiveList中指定categoryId。
以下是专属列表页的模板示例：
”`twig {# 假设这是某个分类的专属列表页模板，如 article/list.html 或 article/list-123.html #} {% categoryDetail currentCategory %} {# 获取当前分类的详细信息 #}
{{ currentCategory.Title }} 的文章列表
{% archiveList articles with type=“page” limit=“10” %} {# categoryId 会自动从当前页面获取 #}
{% for article in articles %}
<div class="article-item">
<h3><a href="{{ article.Link }}">{{ article.Title }}</a></h3>
<p class="description">{{ article.Description }}</p>
<span class="meta-info">发布日期: {{ stampToDate(article.CreatedTime, "2006-01-02") }} | 浏览量: {{ article.Views }}</span>
</div>
{% empty %}
<p>该分类下暂无文章。</p>
{% endfor %}
{% endarchiveList %}
{# 分页控件 #} {% pagination pages with show=“5” %}
<nav class="pagination-controls">
{% if pages.FirstPage %}
<a href="{{ pages.FirstPage.Link }}" class="page-link">首页</a>
{% endif %}
{% if pages.PrevPage %}
<a href="{{ pages.PrevPage.Link }}" class="page-link">上一页</a>
{% endif %}