`categoryList`标签如何实现多级分类的嵌套显示？

好的，作为一位资深的网站运营专家，我很乐意为您深入解析安企CMS中categoryList标签如何实现多级分类的嵌套显示，并将其转化为一篇易于理解且实用的文章。

安企CMS categoryList 标签：轻松实现多级分类的嵌套显示，让网站结构清晰有序

在网站运营中，清晰的分类体系对于用户体验（UX）和搜索引擎优化（SEO）都至关重要。一个结构良好的网站能够帮助用户快速找到所需信息，同时也能让搜索引擎更好地理解网站内容层次，从而提升排名。安企CMS作为一款功能强大的内容管理系统，提供了categoryList标签，让我们可以得心应手地构建出复杂且富有层次感的网站分类结构。

今天，我们就来深入探讨如何利用categoryList标签，优雅地实现多级分类的嵌套显示。

一、理解 categoryList 标签的核心功能

首先，让我们回顾一下categoryList标签的基本作用。在安企CMS的模板设计中，categoryList标签主要用于获取指定内容模型（如文章、产品等）下的分类列表。它的基本使用形式通常是这样的：

{% categoryList categories with moduleId="1" parentId="0" %}
    <!-- 在这里遍历分类数据 -->
{% endcategoryList %}

这里有两个非常关键的参数：

• moduleId：用于指定要获取哪个内容模型的分类。例如，"1"可能代表文章模型，"2"代表产品模型。您需要根据自己的后台设置来确定正确的ID。
• parentId：这是实现多级分类嵌套的核心。
  • 当parentId="0"时，它会获取所有顶级分类，即没有任何父级分类的分类。
  • 当parentId设置为某个具体分类的ID时，它会获取该ID下的所有直接子分类。
  • 当您在分类列表页面希望获取当前分类的兄弟分类时，可以设置为parentId="parent"。

通过categoryList标签获取到的分类数据，通常会以一个名为categories（或者您自定义的变量名）的数组对象返回。我们可以使用for循环来遍历这个数组，并访问每个分类的详细信息，如item.Id（分类ID）、item.Title（分类名称）、item.Link（分类链接）等。其中，item.HasChildren这个字段尤为重要，它能帮助我们判断当前分类是否有下级子分类，从而决定是否需要继续嵌套显示。

二、实现多级分类嵌套：步步为营的模板构建

要实现多级分类的嵌套显示，我们通常会采用“外层循环获取父级，内层循环获取子级”的策略。下面，我们通过一个三级分类的例子来详细说明：

1. 获取顶级分类

首先，我们从最顶层开始，获取所有一级分类。这通过设置parentId="0"来实现：

{% categoryList topCategories with moduleId="1" parentId="0" %}
    <ul class="level-1-categories">
        {% for item in topCategories %}
            <li class="category-item-1">
                <a href="{{ item.Link }}">{{ item.Title }}</a>
                <!-- 这里将是嵌套二级分类的地方 -->
            </li>
        {% endfor %}
    </ul>
{% endcategoryList %}

在上面的代码中，topCategories变量包含了所有的一级分类，我们遍历它们，并为每个分类生成一个链接。

2. 嵌套获取二级分类

紧接着，在遍历一级分类的for循环内部，我们可以再次使用categoryList标签来获取当前一级分类的子分类。此时，parentId参数就应该设置为当前一级分类的Id，即item.Id：

{% categoryList topCategories with moduleId="1" parentId="0" %}
    <ul class="level-1-categories">
        {% for item in topCategories %}
            <li class="category-item-1">
                <a href="{{ item.Link }}">{{ item.Title }}</a>
                {% if item.HasChildren %} <!-- 判断当前分类是否有子分类 -->
                    <ul class="level-2-categories">
                        {% categoryList subCategories with parentId=item.Id %} <!-- 获取当前一级分类的子分类 -->
                            {% for inner1 in subCategories %}
                                <li class="category-item-2">
                                    <a href="{{ inner1.Link }}">{{ inner1.Title }}</a>
                                    <!-- 这里将是嵌套三级分类的地方 -->
                                </li>
                            {% endfor %}
                        {% endcategoryList %}
                    </ul>
                {% endif %}
            </li>
        {% endfor %}
    </ul>
{% endcategoryList %}

可以看到，通过在父级分类的循环内再次调用categoryList，并将父级分类的Id传递给parentId，我们就成功获取并显示了二级分类。{% if item.HasChildren %} 的判断让我们的代码更加健壮，避免在没有子分类的项下生成空的<ul>标签。

3. 持续嵌套获取三级及更多层级

依此类推，如果您需要显示三级分类，只需在二级分类的循环内部重复上述步骤，将parentId设置为当前二级分类的Id（即inner1.Id）：

”`twig {% categoryList topCategories with moduleId=“1” parentId=“0” %}

<ul class="level-1-categories">
    {% for item in topCategories %}
        <li class="category-item-1">
            <a href="{{ item.Link }}">{{item.Title}}</a>
            {% if item.HasChildren %}
                <ul class="level-2-categories">
                    {% categoryList subCategories with parentId=item.Id %}
                        {% for inner1 in subCategories %}
                            <li class="category-item-2">
                                <a href="{{ inner1.Link }}">{{inner1.Title}}</a>
                                {% if inner1.Has