作为一位资深的安企CMS网站运营人员，我深知灵活管理网站分类体系对于内容组织和用户体验至关重要。尤其是当您的网站内容日益丰富，分类结构变得复杂时，能够准确、高效地获取特定分类下的所有子分类列表，是模板开发和内容展示中不可或缺的能力。安企CMS提供了强大且易用的模板标签系统，让这一操作变得非常简单。
灵活获取安企CMS特定分类下的所有子分类列表
在安企CMS中，获取特定分类下的子分类列表主要依赖于核心的 categoryList 模板标签。这个标签旨在帮助您检索文章、产品或其他自定义内容模型下的分类数据，并提供参数以精确定位您所需的数据范围。
核心标签：categoryList 的功能解析
categoryList 标签是您操作分类数据的起点。它不仅能列出顶级分类，更能根据指定的父级分类ID，逐层向下检索其直接子分类，甚至可以实现多级嵌套的分类展示。其基本使用方式是 {% categoryList 变量名称 with 参数 %}，其中 变量名称 是您自定义的，用于在标签块内部引用返回的分类列表数据。
通过 parentId 参数指定父分类
要获取一个特定分类下的子分类列表，最关键的参数就是 parentId。您可以通过以下几种方式来使用它：
获取顶级分类：如果您想列出所有没有父分类的顶级分类，可以将
parentId设置为0。同时，由于分类数据是与内容模型关联的，您还需要通过moduleId参数指定是哪个内容模型下的顶级分类（例如，文章模型ID为1，产品模型ID为2）。{% categoryList categories with moduleId="1" parentId="0" %} {# 在这里遍历顶级分类 #} {% endcategoryList %}获取指定分类的直接子分类：如果您已知某个分类的ID，并希望获取其直接子分类，可以直接将该ID赋值给
parentId。例如，要获取ID为10的分类下的所有直接子分类，您可以这样操作：{% categoryList subCategories with parentId="10" %} {# 在这里遍历ID为10的分类的直接子分类 #} {% endcategoryList %}在分类详情页获取当前分类的子分类：当您处于一个分类的详情页面时，安企CMS能够自动识别当前分类的上下文。因此，如果您省略
parentId参数，categoryList标签将默认获取当前分类的直接子分类。{# 假设当前页面是某个分类的详情页 #} {% categoryList currentCategorySubCategories %} {# 在这里遍历当前分类的直接子分类 #} {% endcategoryList %}
实现多级嵌套子分类列表
在实际运营中，分类结构往往不止两层。安企CMS的 categoryList 标签结合模板引擎的循环嵌套能力，可以非常灵活地构建任意深度的多级子分类列表。通过判断每个分类项是否拥有子分类（HasChildren 字段），我们可以实现动态的递归展示。
以下是一个实现三级分类嵌套的典型代码示例，它展示了如何从顶级分类开始，逐层深入到其子分类：
{% categoryList topCategories with moduleId="1" parentId="0" %}
{# 一级分类列表 #}
<ul>
{% for level1Category in topCategories %}
<li>
<a href="{{ level1Category.Link }}">{{ level1Category.Title }}</a>
{% if level1Category.HasChildren %} {# 判断当前一级分类是否有子分类 #}
{% categoryList level2Categories with parentId=level1Category.Id %}
{# 二级分类列表 #}
<ul>
{% for level2Category in level2Categories %}
<li>
<a href="{{ level2Category.Link }}">{{ level2Category.Title }}</a>
{% if level2Category.HasChildren %} {# 判断当前二级分类是否有子分类 #}
{% categoryList level3Categories with parentId=level2Category.Id %}
{# 三级分类列表 #}
<ul>
{% for level3Category in level3Categories %}
<li>
<a href="{{ level3Category.Link }}">{{ level3Category.Title }}</a>
{# 如果需要更深层级，可以继续嵌套 #}
</li>
{% endfor %}
</ul>
{% endcategoryList %}
{% endif %}
</li>
{% endfor %}
</ul>
{% endcategoryList %}
{% endif %}
</li>
{% endfor %}
</ul>
{% endcategoryList %}
categoryList 标签返回的字段解析
在 categoryList 标签的循环中，每一个 item（在示例中是 level1Category、level2Category、level3Category 等）都包含一系列有用的分类信息，您可以直接通过 item.字段名 的方式访问：
Id: 分类的唯一标识ID。Title: 分类在前台显示的标题名称。Link: 分类对应的URL链接。Description: 分类的简介或描述。ParentId: 当前分类的父分类ID。HasChildren: 一个布尔值，指示当前分类是否包含子分类。这是实现多级嵌套的关键判断依据。Logo/Thumb: 分类的封面大图和缩略图，用于视觉展示。ArchiveCount: 当前分类下的文档数量。
通过这些字段，您可以构建出丰富多样的分类导航、分类区块或内容列表，极大地提升网站的内容组织能力和用户浏览体验。
常见问题解答
Q1: 在模板中，如何判断一个分类是否拥有子分类？
您可以通过 categoryList 标签返回的分类项中的 HasChildren 字段来判断。这是一个布尔值，如果为 true，则表示该分类下有子分类；如果为 false，则表示没有。这在构建多级导航时非常有用，可以控制是否显示子菜单或展开箭头。
Q2: 我想获取不同内容模型下的子分类，应该怎么操作？
categoryList 标签支持 moduleId 参数，您可以使用它来指定您想要查询的分类所属的内容模型ID。例如，moduleId="1" 通常用于文章模型，moduleId="2" 用于产品模型。在获取子分类时，确保您的 moduleId 参数与您希望操作的内容模型相匹配。
Q3: 如果我只想列出指定父分类下的第一级子分类，不希望显示更深层的嵌套，应该如何操作？
如果您只希望显示某个父分类的直接子分类，而不进行递归显示更深层次的子分类，那么在 categoryList 标签内部的 for 循环中，您可以直接使用 parentId 参数来获取其子级，并省略 if item.HasChildren 的判断和内部的嵌套 categoryList 循环。例如，{% categoryList subCategories with parentId=某个已知ID %} 将只会返回该ID下的直接子分类，而不会自动向下获取孙子分类。