`categoryList`和`categoryDetail`标签如何用于构建和显示网站的分类层级结构？

在安企CMS中，网站的分类层级结构是内容组织的核心，它不仅影响用户浏览体验，更是搜索引擎优化的重要环节。为了有效地构建和展示这些分类结构，我们主要依赖两个强大的模板标签：categoryList 和 categoryDetail。它们协同工作，让您能够灵活地在网站前端呈现出清晰、有条理的内容分类。

构建分类列表：categoryList 标签

categoryList 标签的主要作用是列出网站中的一个或多个内容分类。无论您是想构建主导航菜单、侧边栏分类列表，还是在页面底部展示热门分类，categoryList 都能轻松实现。

当您需要使用这个标签时，通常会像这样开始：{% categoryList categories with moduleId="1" parentId="0" %}。这里，categories 是您为这组分类数据指定的变量名，您可以随意命名。moduleId 参数至关重要，它告诉系统您想要获取哪个内容模型下的分类（例如，文章模型ID通常为1，产品模型ID可能为2）。parentId 参数则用于控制您想要获取哪个层级的分类：设置为 "0" 表示获取顶级分类；如果您想获取某个特定分类下的子分类，可以将其设置为该父分类的ID；如果您在一个分类页面中，想获取当前分类的兄弟分类，可以设置 parentId="parent"。

在 categoryList 标签的内部，您可以使用 for 循环遍历获取到的每一个分类项，并访问其各种属性来构建您的列表。例如，item.Title 会显示分类的名称，item.Link 提供分类页面的URL，而 item.Description 则能展示分类的简介。

展示多级分类结构是 categoryList 的一个亮点。通过在内部再次嵌套 categoryList 标签，并利用 item.Id 作为子分类的 parentId，您可以轻松构建出无限层级的导航菜单。同时，item.HasChildren 属性可以帮助您判断一个分类是否有子分类，从而决定是否渲染下一级菜单，让您的导航更具交互性。

例如，创建一个多级分类菜单可能看起来像这样：

<ul class="main-nav">
    {% categoryList topCategories with moduleId="1" parentId="0" %}
        {% for item in topCategories %}
            <li class="nav-item {% if item.HasChildren %}has-dropdown{% endif %}">
                <a href="{{ item.Link }}">{{ item.Title }}</a>
                {% if item.HasChildren %}
                    <ul class="dropdown-menu">
                        {% categoryList subCategories with parentId=item.Id %}
                            {% for subItem in subCategories %}
                                <li class="dropdown-item"><a href="{{ subItem.Link }}">{{ subItem.Title }}</a></li>
                            {% endfor %}
                        {% endcategoryList %}
                    </ul>
                {% endif %}
            </li>
        {% endfor %}
    {% endcategoryList %}
</ul>

通过这样的结构，您的网站导航就能清晰地展示内容的层级关系，方便用户快速找到所需信息。

获取分类详情：categoryDetail 标签

categoryDetail 标签则用于获取单个分类的详细信息。它通常在分类页面（如 list-{分类id}.html）中使用，以显示当前分类的标题、描述、内容或配图等。此外，当您在网站其他位置需要引用某个特定分类的详细数据时，categoryDetail 也非常方便。

这个标签的使用方式通常是：{% categoryDetail with name="Title" %}。如果您在分类详情页调用，它会智能地获取当前页面的分类信息。如果您想获取指定分类的数据，可以传入 id 或 token 参数，例如 {% categoryDetail with name="Description" id="5" %} 将会获取ID为5的分类的描述。

categoryDetail 可以获取的信息非常丰富，包括分类的 Id、Title、Link、Description、Content（分类介绍性文字）、Logo（分类大图或Banner图）、Thumb（分类缩略图），甚至是在后台自定义的额外字段。这让您能够为每个分类页面设计独特且信息丰富的布局。

例如，在文章分类页面的顶部，您可能希望显示当前分类的名称和详细描述，并展示一张分类Banner图：

<div class="category-header">
    <img src="{% categoryDetail with name='Logo' %}" alt="{% categoryDetail with name='Title' %}" class="category-banner">
    <h1>{% categoryDetail with name='Title' %}</h1>
    <p class="category-description">{% categoryDetail with name='Description' %}</p>
    {% categoryDetail categoryContent with name="Content" %}
    <div class="category-full-content">
        {{categoryContent|safe}}
    </div>
</div>

categoryList 与 categoryDetail 的协作

这两个标签并非孤立存在，它们经常相互协作以实现更复杂的功能。例如，在展示文档列表时，每个文档都会关联一个分类ID (item.CategoryId)。如果您想在文档卡片中显示其所属分类的名称和链接，就可以在 archiveList 循环内部结合 categoryDetail：

{% archiveList archives with type="page" limit="10" %}
    {% for item in archives %}
        <div class="article-card">
            <h3><a href="{{ item.Link }}">{{ item.Title }}</a></h3>
            <p>分类：<a href="{% categoryDetail with name='Link' id=item.CategoryId %}">{% categoryDetail with name='Title' id=item.CategoryId %}</a></p>
            <p>{{ item.Description }}</p>
        </div>
    {% endfor %}
{% endarchiveList %}

这种用法极大地提升了内容呈现的灵活性和丰富性，让文档与分类之间的关系更加直观。

总结

categoryList 和 categoryDetail 是安企CMS模板制作中用于处理分类层级结构不可或缺的标签。通过 categoryList，您可以轻松地构建出各种形式的分类列表和导航菜单；而 categoryDetail 则让您能够深度挖掘每个分类的详细信息，为用户提供更个性化的浏览体验。合理地运用这两个标签，不仅能让您的网站内容井然有序，也能显著提升网站的整体易用性和搜索引擎友好度。

常见问题 (FAQ)

1. 如何在后台管理分类时设置多级分类关系？ 在安企CMS的后台内容管理中，当您添加或编辑分类时，会有一个“上级分类”的选项。通过选择不同的上级分类，您可以轻松地建立起层级结构。例如，创建一个“新闻”分类，然后在其下选择“新闻”作为上级分类来创建“国内新闻”和“国际新闻”，便形成了多级分类。

2. 为什么我在模板中使用了 categoryList 却什么内容都没显示？ 这通常有几个原因。首先，请检查 moduleId 参数是否正确，它需要与您希望展示的分类所属的内容模型ID匹配。其次，parentId 参数是否设置得当，例如，如果您想显示顶级分类，确保 parentId 为 "0"。最后，确认您在后台确实创建了分类，并且这些分类都属于您指定的 moduleId。

**3. 我想为特定的分类页面使用自定义的模板样式，应该