如何使用`categoryList`标签获取所有顶级分类列表？
你好！作为一名资深的网站运营专家，我很乐意为你详细解读安企CMS中categoryList标签的强大功能，特别是如何精准地获取你网站上的所有顶级分类列表。理解并运用好这个标签，将是你构建清晰、高效网站导航系统的关键一步。
安企CMS实战：巧用categoryList标签，轻松呈现网站顶级分类导航
在内容管理系统中，分类是组织信息、引导用户浏览的核心骨架。无论是文章、产品，还是其他任何内容类型，清晰的分类结构都能极大提升用户体验和搜索引擎友好度。安企CMS（AnQiCMS）凭借其灵活的内容模型设计，让分类管理变得游刃有余。而这一切，都离不开一个至关重要的模板标签——categoryList。
今天，我们将深入探讨如何巧妙运用categoryList标签，精准地获取网站上的所有顶级分类列表，为你的网站构建一个坚实而直观的导航基础。
核心功能解析：categoryList标签是何物？
categoryList标签是安企CMS模板引擎提供的一个功能强大且灵活的工具，它的主要职责就是从数据库中提取并呈现分类信息。通过它，你可以根据不同的条件筛选出所需的分类列表，例如，用于生成主导航菜单、侧边栏分类树，或是网站底部的分类索引等。它能帮助你避免手动维护分类列表的繁琐工作，实现网站结构的动态更新。
获取所有顶级分类：parentId="0"与moduleId的巧妙配合
要获取网站上的所有顶级分类，你需要理解categoryList标签的两个核心参数：parentId和moduleId。
parentId="0"：筛选最高层级parentId参数用于指定要获取的分类的父级ID。当你将parentId的值设置为"0"时，你实际上是在告诉安企CMS系统：“我只想要那些没有上级分类的，也就是层级最高的分类。” 这些分类通常是你网站内容体系中的一级分类，它们是所有子分类的根。moduleId：限定内容模型 安企CMS的一大优势在于其高度定制化的内容模型。你的网站可能同时存在“文章”、“产品”、“下载”等多种内容模型，每种模型都有自己独立的分类体系。为了确保你获取到的是正确内容模型下的顶级分类，你必须通过moduleId参数来明确指定。例如，如果你的“文章模型”的ID是1，“产品模型”的ID是2，那么你就需要根据需要传入相应的ID。
将这两个参数结合使用，我们就能精确地筛选出某一特定内容模型下的所有顶级分类。下面是一个实际的模板代码示例：
<nav>
<ul>
{# 假设文章模型的ID是1，这里获取所有顶级文章分类 #}
{% categoryList topArticleCategories with moduleId="1" parentId="0" %}
{% for category in topArticleCategories %}
<li><a href="{{ category.Link }}">{{ category.Title }}</a></li>
{% endfor %}
{% endcategoryList %}
{# 假设产品模型的ID是2，这里获取所有顶级产品分类 #}
{% categoryList topProductCategories with moduleId="2" parentId="0" %}
{% for category in topProductCategories %}
<li><a href="{{ category.Link }}">{{ category.Title }}</a></li>
{% endfor %}
{% endcategoryList %}
</ul>
</nav>
在这个例子中，topArticleCategories和topProductCategories是我们为列表数据自定义的变量名，你可以根据自己的习惯来命名。{% for category in ... %} 循环会遍历获取到的每一个顶级分类，并将其数据赋值给category这个临时变量，方便我们进行后续的显示。
理解分类数据：categoryList返回的宝藏
当categoryList标签成功获取到分类数据后，它会返回一个包含多个分类对象的数组。每个分类对象都封装了丰富的属性信息，你可以根据需求在模板中灵活调用。以下是一些你最常会用到的属性：
Id：分类的唯一标识符，常用于内部逻辑判断或链接构建。Title：分类的名称，这是用户最直观看到的分类标题。Link：分类页面的URL地址，直接用于构建导航链接。Description：分类的简短描述，可以在悬停提示或SEO元信息中使用。Logo和Thumb：分类的封面大图和缩略图，适用于需要图片展示的导航或分类列表。HasChildren：一个布尔值（true或false），指示当前分类是否有下级分类。这对于构建多级下拉菜单的交互效果非常有用。ArchiveCount：该分类下包含的内容（文章、产品等）数量，可以用于显示分类内容的丰富度。
通过这些属性，你可以轻松地构建出美观且功能完善的顶级分类导航。
实战应用：构建一个清晰的顶级导航
现在，让我们把上述知识点整合起来，看一个更完整的构建顶级导航的场景。假设我们想在网站头部显示文章和产品两大模块的顶级分类，并为有子分类的项添加视觉提示：
<header>
<nav class="main-navigation">
<ul>
{# 获取文章模块的顶级分类 #}
{% categoryList articleNav with moduleId="1" parentId="0" %}
{% for category in articleNav %}
<li class="nav-item {% if category.HasChildren %}has-dropdown{% endif %}">
<a href="{{ category.Link }}">{{ category.Title }}</a>
{# 如果有下级分类，可以进一步在这里渲染子菜单，这里只是一个占位符 #}
{% if category.HasChildren %}
<span class="dropdown-icon">▼</span>
{# 这里可以嵌套另一个 categoryList 标签来获取子分类 #}
{# 例如：{% categoryList subCategories with parentId=category.Id %}{# ... #}{% endcategoryList %} #}
{% endif %}
</li>
{% endfor %}
{% endcategoryList %}
{# 获取产品模块的顶级分类 #}
{% categoryList productNav with moduleId="2" parentId="0" %}
{% for category in productNav %}
<li class="nav-item {% if category.HasChildren %}has-dropdown{% endif %}">
<a href="{{ category.Link }}">{{ category.Title }}</a>
{% if category.HasChildren %}
<span class="dropdown-icon">▼</span>
{# 同样，这里可以嵌套获取子分类 #}
{% endif %}
</li>
{% endfor %}
{% endcategoryList %}
</ul>
</nav>
</header>
这段代码不仅展示了如何获取顶级分类，还引入了HasChildren属性，让你能够为含有子分类的导航项添加特定的样式或交互效果，从而构建更具层次感的网站导航。你可以根据需要，进一步嵌套categoryList标签，实现多级分类的展示。
进阶用法小贴士
控制显示数量：
limit参数 如果你只想显示一部分精选的顶级分类，可以使用limit参数来限制数量，例如：limit="5"。这在首页的“热门分类”等场景非常实用。多站点场景：
siteId参数 安企CMS支持多站点管理。如果你在一个AnQiCMS实例下运营多个网站，并且需要调用不同站点的分类数据，可以使用siteId参数来指定要获取哪个站点的分类列表。例如：with siteId="2" moduleId="1" parentId="0"。排序：
order参数 虽然在获取顶级分类时通常按后台设置的默认顺序，但categoryList也支持order参数，允许你根据id、sort（自定义排序）等进行排序，让分类的展示顺序更符合你的运营策略。
通过对categoryList标签的深入理解和灵活运用，你将能够高效地管理和展示网站的分类结构，为你的用户提供更优质的浏览体验，也为网站的SEO打下坚实的基础。
常见问题解答 (FAQ)
问：为什么我使用了
parentId="0"，但categoryList标签仍然没有显示任何分类？ 答： 最常见的原因是你可能忘记了同时指定moduleId参数。安企CMS拥有多种内容模型，每个模型都有独立的分类体系。如果你没有告诉系统你想获取哪个内容模型下的顶级分类，它就无法找到匹配的数据。请确保你的标签中同时包含了moduleId="X"，其中X是你所需内容模型的ID。问：我只想获取某个特定内容模型下的所有分类，无论它们是否是顶级分类，应该怎么做？ 答： 如果你想获取某个