如何在`archiveList`循环中判断文档是否属于当前页面的分类？
作为一名资深的网站运营专家，我深知在内容管理系统中，模板的灵活运用是提升网站动态性与用户体验的关键。安企CMS（AnQiCMS）以其基于Go语言的高效架构和Django风格的模板语法，为我们提供了强大的内容展现能力。今天，我们就来深入探讨一个非常实用的模板技巧：如何在archiveList循环中，巧妙判断当前文档是否属于当前页面的分类。
灵活内容呈现的基石：理解archiveList与分类判断
在日常的内容运营中，我们经常会遇到这样的需求：在一个分类页面，我们可能需要展示该分类下的文章，同时也在侧边栏或底部展示一些最新的、热门的文章，这些文章可能来自不同的分类。这时候，如果能清晰地标识出哪些文章是当前分类的，哪些不是，就能极大提升用户体验和内容组织的逻辑性。
安企CMS的archiveList标签，是用来获取和展示文档列表的强大工具。它能够根据多种条件（如模型ID、分类ID、推荐属性、排序方式等）灵活地筛选出我们所需的文档。而当我们谈论“当前页面的分类”时，通常指的是用户正在浏览的分类列表页，或者某个文档详情页所归属的分类。
要实现这个判断，我们需要两部分关键信息：首先是当前页面所代表的分类ID；其次是在archiveList循环中，每个文档自身的分类ID。安企CMS的模板标签体系，完美地支持我们获取这些信息。
第一步：获取当前页面的分类ID
无论您身处分类列表页，还是某个文档的详情页，只要该页面与某个分类关联，安企CMS都能通过categoryDetail标签轻松获取到当前分类的详细信息，包括它的ID。
我们可以这样来获取当前分类的ID并将其存储在一个变量中：
{# 假设我们当前正处于一个分类页面，或者一个文章详情页，且该文章归属于某个分类。 #}
{# categoryDetail 标签会自动识别当前页面的分类信息。我们从中提取其ID。 #}
{% categoryDetail currentCategory with name="Id" %}
{% set currentCategoryId = currentCategory %}
{# 此时，变量 currentCategoryId 就存储了当前页面的分类ID，比如：10、25等。 #}
这里，我们使用categoryDetail标签获取了当前分类的ID，并将其赋值给了currentCategoryId这个变量。这样做的好处是，currentCategoryId现在是模板上下文中的一个普通变量，方便我们在后续的循环中进行比较。
第二步：遍历文档列表并进行分类ID比较
接下来，我们使用archiveList标签来获取我们想要展示的文档列表。为了演示判断逻辑，这里我们可以故意获取一个范围更广的文档列表，例如，网站上最新的10篇文章，这些文章可能来自不同的分类。
{# 假设我们现在需要展示网站上最新的10篇文章，无论它们属于哪个分类。 #}
{# 我们使用 moduleId="1"（通常代表文章模型），不指定 categoryId 参数，以获取一个跨分类的近期文章列表。 #}
{% archiveList allRecentArchives with moduleId="1" type="list" limit="10" %}
<div class="article-listing">
{% for archiveItem in allRecentArchives %}
<div class="article-card">
<a href="{{ archiveItem.Link }}">
<h4>{{ archiveItem.Title }}</h4>
</a>
{# 核心判断逻辑：检查当前循环中的文档是否属于当前页面的分类 #}
{% if archiveItem.CategoryId == currentCategoryId %}
<span style="color: green; font-weight: bold;">[当前分类精选]</span>
{% else %}
<span style="color: gray;">[其他推荐]</span>
{% endif %}
<p>{{ archiveItem.Description }}</p>
<small>发布于：{{ stampToDate(archiveItem.CreatedTime, "2006-01-02") }}</small>
</div>
{% if not forloop.Last %}<hr>{% endif %} {# 除了最后一项，每项后面加分隔线 #}
{% empty %}
<p>很抱歉，当前暂无相关的文章内容。</p>
{% endfor %}
</div>
{% endarchiveList %}
在这段代码中，archiveItem是archiveList循环中每一篇文章的代表。通过archiveItem.CategoryId，我们可以直接访问到当前循环文章的所属分类ID。然后，我们使用{% if archiveItem.CategoryId == currentCategoryId %}这个条件判断，将文章的分类ID与我们之前获取到的currentCategoryId进行比较。如果两者相等，就说明这篇文章属于当前页面所在的分类。
通过这种方式，我们可以在同一个文档列表中，根据文章所属分类与当前页面的关联性，展示不同的样式或信息，例如添加一个特殊的角标、改变标题颜色，或者提供更具体的提示信息。
实际应用场景与价值
这种判断能力，不仅仅是简单的技术实现，更是提升网站内容组织逻辑性和用户体验的关键：
- 增强用户引导： 在一个包含混合内容的列表中，清晰地标识出“当前分类”的内容，能帮助用户快速找到与他们兴趣最相关的文章，减少信息过载的困扰。
- 个性化内容推荐： 您可以根据用户的浏览路径，在相关推荐中突出显示与用户当前所在分类一致的文章，提升内容的点击率和转化率。
- 灵活的UI设计： 这种判断为模板设计带来了更大的自由度。您可以为当前分类的文章设计独特的卡片样式、背景色或图标，使其在视觉上更具吸引力，一眼可见。
- SEO优化辅助： 通过有针对性的内容展示，可以进一步强化页面主题，有助于搜索引擎更好地理解页面内容，潜在提升相关关键词的排名。
安企CMS的模板系统以其简洁而强大的标签，让这些复杂的逻辑变得易于实现。掌握了这种在循环中进行分类判断的技巧，您就能更精细地控制内容展示，为网站用户提供更加流畅和个性化的浏览体验。
常见问题 (FAQ)
1. archiveList 标签的 categoryId 参数和循环中的 item.CategoryId 有什么区别？
archiveList 标签的 categoryId 参数用于在查询阶段过滤文档，告诉系统“我只需要这些特定分类的文档”。例如，categoryId="1"只会获取ID为1的分类下的文档。
而 item.CategoryId 是在 archiveList 循环内部，每个 item（即每篇文档）所自带的一个属性，它表示这篇文档实际属于哪个分类。
本文介绍的技巧是，您可以让archiveList获取一个更宽泛的文档列表（例如不指定categoryId，或者指定多个categoryId），然后在循环内部利用item.CategoryId来判断每一篇文档的具体归属，从而实现更精细的展示逻辑。
2. 除了判断文档是否属于当前分类，我还能利用 item 对象进行哪些条件判断？
archiveList循环中的item对象包含了文档的丰富信息，您可以进行多种条件判断：
- 推荐属性 (
Flag)：{% if item.Flag contains "h" %}（判断是否为头条文章）。 - 浏览量 (
Views)：{% if item.Views > 1000 %}（判断是否为热门文章）。 *