作为一名资深的网站运营专家，我深知一个内容管理系统（CMS）的强大之处，不仅在于其后台功能的完善，更在于前端内容展示的灵活性。AnQiCMS（安企CMS）正是这样一款出色的工具，它基于Go语言的高性能架构，配合其简洁高效的模板标签系统，能够让我们轻松驾驭各种复杂的内容展示需求。
今天，我们就来深入探讨AnQiCMS中两个核心标签——categoryList和archiveList——如何巧妙协同，帮助我们在网站的每个分类下，精准地展示其最新的几篇文档，从而极大地丰富页面内容，提升用户体验。
1. 理解基石：分类列表标签 categoryList
在AnQiCMS中，categoryList标签是管理和展示网站分类结构的利器。它允许我们获取特定内容模型下的分类信息，无论是文章、产品还是其他自定义模型，都能通过它进行灵活调用。
当我们使用categoryList时，可以指定一些关键参数来控制其行为，例如：
moduleId：告诉系统我们想要获取哪个内容模型（比如文章模型ID为1，产品模型ID为2）下的分类。parentId：用于构建分类层级关系，parentId="0"表示获取所有顶级分类，而指定某个分类的ID则可以获取其下的子分类。limit：限制返回的分类数量，比如只想展示前10个分类。
这个标签会返回一个分类对象数组，每个对象都包含了诸如分类ID（Id）、分类标题（Title）、分类链接（Link）、是否有子分类（HasChildren）等关键信息。这些信息将成为我们后续获取分类下文档的桥梁。
2. 内容核心：文档列表标签 archiveList
有了分类，自然需要展示分类下的具体内容。archiveList标签就是AnQiCMS中用于获取文档（或称为档案，如文章、产品等）列表的核心工具。它能够满足从常规列表、相关文档到分页显示等多种场景的需求。
archiveList的强大之处同样体现在其丰富的参数配置上，其中与我们今天主题密切相关的有：
categoryId：这是连接categoryList的关键，通过这个参数，我们可以指定获取哪个分类下的文档。limit：控制每个分类下要展示多少篇文档，例如“最新的5篇”。order：决定文档的排序方式。为了实现“最新”展示，我们通常会使用order="id desc"（按文档ID降序，即最新发布的在前）或者order="createdTime desc"（按创建时间降序）。如果想展示热门文档，则可以使用order="views desc"（按浏览量降序）。type：为了在非分类列表页（如首页或特定模块）展示固定数量的文档，我们一般会将type设置为"list"。
archiveList同样会返回一个文档对象数组，每个对象包含文档ID（Id）、标题（Title）、链接（Link）、摘要（Description）、发布时间（CreatedTime）以及缩略图（Thumb）等实用信息。
3. 协同工作：在每个分类下展示最新文档
现在，我们将categoryList和archiveList这两个标签巧妙地组合起来，实现我们的目标：在每个分类下展示其最新的几篇文档。
其核心思路是：首先使用categoryList遍历出所有需要展示的分类，然后在每次遍历到分类时，再在该循环内部嵌套使用archiveList，并将其categoryId动态绑定到当前分类的ID，同时设置limit和order参数以获取指定数量的最新文档。
让我们通过一个具体的模板代码示例来理解这一过程：
{# 外层：使用 categoryList 获取指定模型下的所有顶级分类 #}
{% categoryList categories with moduleId="1" parentId="0" %}
{# 遍历每个获取到的分类 #}
{% for category in categories %}
<section class="category-block">
<h3>
<a href="{{ category.Link }}">{{ category.Title }}</a>
<small>（共 {{ category.ArchiveCount }} 篇文章）</small>
</h3>
<ul class="latest-articles-list">
{# 内层：嵌套使用 archiveList 获取当前分类下的最新文档 #}
{# categoryId 动态绑定为当前分类的 Id #}
{# limit 限制只显示最新的 5 篇文章 #}
{# order="id desc" 确保按 ID 降序，即最新发布在前 #}
{% 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 class="no-content">该分类下暂时没有文档发布。</li>
{% endfor %}
{% endarchiveList %}
</ul>
</section>
{% endfor %}
{% endcategoryList %}
代码解析：
{% categoryList categories with moduleId="1" parentId="0" %}：这行代码会获取文章模型（moduleId="1"）下所有顶级分类（parentId="0"），并将结果存储在categories变量中。{% for category in categories %}：我们开始遍历这些顶级分类，每次循环，category变量都代表一个独立的分类对象。<h3><a href="{{ category.Link }}">{{ category.Title }}</a></h3>：这里展示了当前分类的标题和链接，方便用户点击查看更多内容。{% archiveList archives with type="list" categoryId=category.Id limit="5" order="id desc" %}：这是实现核心功能的关键。在这里，categoryId被动态地设置为当前category的Id。limit="5"告诉系统我们只需要最新的5篇文档，而order="id desc"则确保了这些文档是按发布顺序从新到旧排列的。type="list"则确保了我们获取的是一个固定数量的列表，而非用于分页的数据。{% for article in archives %}：我们继续遍历在当前分类下获取到的最新文档。<li><a href="{{ article.Link }}">{{ article.Title }}</a>...</li>：展示每篇文档的标题、链接以及使用stampToDate过滤器格式化后的发布日期。{% empty %}：这是一个非常实用的标签，当archiveList（或任何for循环）没有获取到任何文档时，empty块中的内容就会被显示出来。这能有效避免页面出现空白区域，提供更友好的用户体验。
通过这种嵌套调用的方式，我们便能在网站的首页、某个特定专题页，或者任何需要聚合展示多个分类内容的页面，以结构化且美观的方式呈现每个分类的最新动态，极大地提升了网站的信息密度和吸引力。
4. 实际场景与应用价值
这种categoryList与archiveList的协同工作模式在实际网站运营中有着广泛的应用：
- 网站首页动态区：可以轻松构建“最新新闻”、“产品更新”、“行业动态”等模块，每个模块都对应一个分类，并展示该分类下的数条最新信息。
- 专题页面聚合：针对某个主题创建的专题页，可以聚合多个相关分类的最新内容，让用户一站式获取所需信息。
- 侧边栏内容推荐：在分类列表页的侧边栏，可以展示当前分类下“最热点击”或“最新发布”的文档，引导用户深入浏览。
这种灵活的内容组合能力，不仅能够满足内容运营者多样化的展示需求，也能够优化网站的SEO结构，增加内部链接，并最终提升用户的浏览体验和网站的专业度。
5. 常见问题 (FAQ)
Q1: 我只想显示某个特定分类的最新文档，而不是所有分类，怎么办？
A1: 如果您只需要展示某个特定分类下的最新文档，而无需遍历所有分类，可以直接省略外层的categoryList标签，单独使用archiveList。例如，要显示ID为10的分类下的最新5篇文档，您可以直接这样写：
<ul class="single-category-latest">
{% archiveList archives with type="list" categoryId="10" limit="5" order="id desc" %}
{% for article in archives %}
<li><a href="{{ article.Link }}">{{ article.Title }}</a></li>
{% empty %}
<li class="no-content">该分类下暂无最新文档。</li>
{% endfor %}
{% endarchiveList %}
</ul>
Q2: archiveList中的order参数，除了id desc，还有哪些常用的排序方式？
A2: order参数非常灵活，可以根据您的需求选择不同的排序字段和顺序：
id desc：按文档ID降序排列，通常等同于最新发布（默认情况下ID是递增的）。createdTime desc：按文档创建时间降序排列，也是获取最新文档的常用方式。views desc：按文档浏览量降序排列，用于展示热门或最受欢迎的文档。sort desc：按后台自定义排序字段降序排列，如果后台对文档设置了自定义排序值，则可以按此值进行排序。 您可以根据实际需要选择最合适的排序方式。
Q3: 如果某个分类下没有文档，页面会显示什么？如何避免空白区域？
A3: 正如文章示例所示，当archiveList（或其他for循环）没有找到任何符合条件的文档时，AnQiCMS模板引擎的{% empty %}标签就派上用场了。在{% for ... %}和{% endfor %}之间，您可以添加{% empty %}，并在其后放置当循环内容为空时需要展示的提示信息。这样可以有效避免页面出现大面积空白，提供更友好的用户体验，例如：“该分类下暂无最新文档。”或“内容正在更新中，敬请期待！”。