如何获取当前页面分类的所有直接子分类列表？

作为一位资深的网站运营专家，我深知在管理内容丰富的网站时，如何高效地组织和展示分类结构是至关重要的。安企CMS（AnQiCMS）凭借其强大的模板标签系统，为我们提供了极大的灵活性，能够轻松实现各种复杂的分类展示需求。今天，我们就来深入探讨一个常见而实用的场景：如何在当前页面分类下，获取并展示其所有的直接子分类列表。

理解安企CMS的分类体系

在安企CMS中，内容组织的核心在于其灵活的内容模型（如文章、产品等）和基于这些模型的分类。分类以树状结构存在，这意味着每个分类都可以有自己的父级分类和多个子级分类，形成清晰的层级关系。这种结构使得我们可以为不同类型的内容创建专属的归类方式，极大地提升了内容的可管理性和用户浏览的便利性。无论是网站的主导航、侧边栏菜单，还是面包屑导航，分类都扮演着不可或缺的角色。

明确目标：获取当前分类的直接子分类

我们的目标非常明确：当我们访问一个分类页面时，希望能够动态地展示该分类下所有的下一级子分类。例如，如果当前是“新闻中心”分类，我们可能希望显示“公司新闻”、“行业动态”等子分类；如果当前是“产品分类”，我们则希望列出“电子产品”、“家居用品”等其直接子类别。

实现这一目标，我们需要分两步走：首先，确定当前页面的分类ID；其次，利用这个ID去查询并列出它的直接子分类。

第一步：获取当前分类的身份标识——分类ID

在安企CMS的模板设计中，要获取当前页面所处分类的详细信息，我们可以借助功能强大的categoryDetail标签。这个标签专门用于获取指定分类的详细数据，如果我们不为其提供id或token参数，它会非常智能地自动识别并获取当前页面的分类信息。

为了后续查询其子分类，我们最需要的就是当前分类的Id。我们可以像下面这样，将当前分类的ID赋值给一个模板变量：

{% categoryDetail currentCategoryId with name="Id" %}

这里，currentCategoryId就是一个包含了当前分类ID的变量。通过这种方式，我们无论身处哪个分类页面，都能准确无误地获取到其唯一的身份标识。

第二步：驾驭 categoryList 标签，列出直接子分类

有了当前分类的ID，下一步就是利用它来查找其下属的直接子分类了。这时，categoryList标签就派上了用场。categoryList标签允许我们根据特定的条件（如所属内容模型、父级分类ID等）来获取分类列表。

它的核心参数包括：

• moduleId：指定分类所属的内容模型。例如，文章模型通常对应的ID是1，产品模型可能对应2。这个参数非常重要，因为它明确了我们希望从哪个内容模型中获取分类。如果你不确定具体模型的ID，可以在后台的“内容管理” -> “内容模型”中查看。
• parentId：这是实现我们目标的关键。将我们刚刚获取到的currentCategoryId赋值给parentId，就可以精确地告诉系统：“请给我列出ID为currentCategoryId的这个分类下面的所有直接子分类！”
• limit：控制返回的子分类数量，根据需要可以限制显示的数量，例如limit="10"。
• siteId：如果你的AnQiCMS部署了多个站点，并且希望获取特定站点的分类，可以通过这个参数指定。通常情况下，如果只管理一个站点，无需填写。

现在，让我们把这两个步骤结合起来，构建一个完整的代码片段：

{% categoryDetail currentCategoryId with name="Id" %}
{% categoryList childCategories with moduleId="1" parentId=currentCategoryId %}
    {% for item in childCategories %}
        <a href="{{ item.Link }}" title="{{ item.Title }}">
            {{ item.Title }}
        </a>
        {# 进一步判断是否有孙子分类，并显示 #}
        {% if item.HasChildren %}
            <ul>
                {% categoryList grandChildCategories with parentId=item.Id %}
                    {% for grandChild in grandChildCategories %}
                        <li><a href="{{ grandChild.Link }}">{{ grandChild.Title }}</a></li>
                    {% endfor %}
                {% endcategoryList %}
            </ul>
        {% endif %}
    {% empty %}
        <p>当前分类暂无直接子分类。</p>
    {% endfor %}
{% endcategoryList %}

在这段代码中：

1. 我们首先使用categoryDetail获取当前页面的分类ID，并存储在currentCategoryId变量中。
2. 接着，我们调用categoryList，指定moduleId为1（假设我们处理的是文章分类），并将parentId设置为currentCategoryId。这样，childCategories变量就会包含当前分类的所有直接子分类。
3. 通过{% for item in childCategories %}循环，我们逐一遍历这些子分类，并可以利用item.Link获取分类链接，item.Title获取分类名称，轻松构建出一个子分类导航列表。
4. 我们还增加了一个{% if item.HasChildren %}的判断，这非常实用。item.HasChildren会返回一个布尔值，指示当前的子分类是否还有更下一级的子分类（即孙子分类）。这样，你可以决定是否需要进一步展示更深层次的分类结构。
5. 最后，{% empty %}标签提供了一个友好的用户体验，当没有任何子分类被找到时，它会显示一条提示信息，避免页面空白。

优化与扩展建议

• 样式美化：上述代码仅展示了逻辑结构，你可以根据自己的设计需求，通过CSS来美化这些子分类的显示样式。
• 层级展示：如果你需要展示多层级的子分类，可以在{% if item.HasChildren %}的内部再次嵌套categoryList标签，并将其parentId设置为item.Id，以此类推，实现无限层级的分类导航。不过，为了用户体验，通常不建议展示过深的层级。
• 灵活控制显示数量：善用`limit