如何在AnQiCMS中显示多级嵌套的分类列表，如顶级分类及其子分类？
在构建网站时，一个清晰、有组织的内容结构是提升用户体验和搜索引擎友好度的基石。尤其对于内容丰富的网站，如何高效地展示多级嵌套的分类列表，如顶级分类及其子分类，是许多运营者关心的问题。AnQiCMS作为一款灵活的企业级内容管理系统，提供了直观而强大的模板标签，让您可以轻松实现这一需求。
AnQiCMS如何组织分类内容
在AnQiCMS的后台，分类管理是内容结构的核心。您可以为不同的内容模型（如文章、产品等）创建独立的分类体系。每个分类都可以拥有自己的父级分类，从而构建出深浅不一的层级关系。例如，您可以有一个“新闻中心”的顶级分类，其下包含“公司新闻”、“行业动态”等子分类，而“行业动态”下可能还有更细分的“技术趋势”、“市场分析”等。这种分层不仅方便管理，也为前端展示多级嵌套列表打下了基础。
模板调用的核心：categoryList 标签
要在网站前端显示这些多级分类，AnQiCMS主要依赖于其强大的categoryList模板标签。这个标签能够帮助我们获取指定条件下的分类数据，是构建多级列表的关键工具。
当我们想要获取所有顶级分类时，可以这样使用categoryList标签：
{% categoryList categories with moduleId="1" parentId="0" %}
{# 在这里循环处理顶级分类数据 #}
{% endcategoryList %}
这里，moduleId="1"通常代表文章模型（具体ID可在后台内容模型中查看），而parentId="0"则明确告诉系统我们只获取没有父级分类的顶级分类。categories是我们为获取到的分类数据定义的变量名，后续可以在循环中通过item或自定义的变量名来访问每一个分类的详细信息。
构建多级嵌套列表的逻辑
AnQiCMS的模板采用了类似Django的语法，循环和条件判断都非常直观，这为构建复杂的嵌套结构提供了便利。要显示多级分类，其核心思路是在遍历父级分类时，检查当前分类是否包含子分类，如果包含，则再次调用categoryList标签来获取并显示其子分类。
下面是一个典型的多级分类嵌套逻辑示例：
{# 获取顶级分类，例如文章模型下的所有顶级分类 #}
{% categoryList categories with moduleId="1" parentId="0" %}
<ul class="main-category-list">
{% for item in categories %}
<li class="category-item">
<a href="{{ item.Link }}">{{ item.Title }}</a>
{# 检查当前分类是否有子分类 #}
{% if item.HasChildren %}
<ul class="sub-category-list">
{# 如果有子分类，再次调用 categoryList 获取这些子分类 #}
{% categoryList subCategories with parentId=item.Id %}
{% for innerItem in subCategories %}
<li class="sub-category-item">
<a href="{{ innerItem.Link }}">{{ innerItem.Title }}</a>
{# 您可以在这里继续嵌套，检查 innerItem.HasChildren 获取三级分类 #}
</li>
{% endfor %}
{% endcategoryList %}
</ul>
{% endif %}
</li>
{% endfor %}
</ul>
{% endcategoryList %}
在这个例子中，我们首先使用parentId="0"获取所有顶级分类。在遍历每个顶级分类item时，我们通过item.HasChildren来判断它是否有子分类。如果为真，我们就嵌套一个内部的categoryList标签，并传入当前顶级分类的item.Id作为parentId，这样就能精确地获取到其直接子分类subCategories。您可以根据需要，重复这种嵌套逻辑来展示更多层级的分类。
结合内容列表展示
很多时候，我们不仅希望展示分类本身，还希望能在某个分类下直接看到其最新的文章或产品列表。AnQiCMS同样提供了便捷的方式来实现这一点。您可以在判断分类是否有子分类的逻辑中，灵活地引入archiveList标签。
举个例子，在顶级分类循环中，如果一个分类没有子分类，我们就可以让它直接显示该分类下的文章：
{# 假设我们正在构建一个产品展示页面， moduleId="2"代表产品模型 #}
<div class="product-categories-section">
{% categoryList productCategories with moduleId="2" parentId="0" %}
{% for item in productCategories %}
<div class="category-block">
<h3><a href="{{ item.Link }}">{{ item.Title }}</a></h3>
<ul class="category-sub-items">
{% if item.HasChildren %}
{# 如果有子分类，显示子分类列表 #}
{% categoryList subCategories with parentId=item.Id %}
{% for subItem in subCategories %}
<li><a href="{{ subItem.Link }}">{{ subItem.Title }}</a></li>
{% endfor %}
{% endcategoryList %}
{% else %}
{# 如果没有子分类，直接显示该分类下的产品列表 #}
{% archiveList products with type="list" categoryId=item.Id limit="8" %}
{% for product in products %}
<li>
<a href="{{ product.Link }}">
<img src="{{ product.Thumb }}" alt="{{ product.Title }}" />
<span>{{ product.Title }}</span>
</a>
</li>
{% empty %}
<li>当前分类下没有产品。</li>
{% endfor %}
{% endarchiveList %}
{% endif %}
</ul>
</div>
{% endfor %}
{% endcategoryList %}
</div>
这个示例展示了如何在一个循环中，根据是否有子分类来决定是继续显示下一级分类，还是显示当前分类下的产品列表。archiveList标签通过categoryId=item.Id参数，精准地获取了当前分类下的内容。
一些实用的小技巧
- 样式控制： 在循环中，
forloop.Counter可以帮助您获取当前循环的索引，常用于为列表项添加不同的样式或编号。item.IsCurrent则可以判断当前分类是否为用户正在访问的页面所对应的分类，便于进行高亮显示。此外，item.Spacer标签可以为子分类自动添加前缀空格，实现视觉上的缩进效果，让层级关系一目了然。 - SEO优化： AnQiCMS内置了全面的SEO工具，包括伪静态规则管理。在设计分类列表时，确保分类链接（
item.Link）使用友好的伪静态URL。同时，利用breadcrumb标签在页面顶部显示面包屑导航，不仅提升用户体验，也有利于搜索引擎理解网站结构。 - 后台管理： 灵活的分类显示顺序、自定义URL以及为特定分类设置独立模板等功能（可在后台“文档分类”中配置），都能帮助您更精细地控制前端展示。
AnQiCMS通过其直观的模板标签和灵活的后台管理，让您能够轻松驾驭复杂的多级分类结构。无论是构建简单的层级导航，还是展示带有内容的复合列表，AnQiCMS都能提供高效且可定制的解决方案，助力您的网站在内容组织和用户体验方面更上一层楼。
常见问题 (FAQ)
1. 如何只获取当前分类的直接子分类，而不是所有层级的子分类？
您只需要在categoryList标签中，明确指定parentId参数为当前父分类的ID即可。例如，如果您想获取ID为10的分类的直接子分类，可以这样写：{% categoryList subCategories with parentId="10" %}。在循环中，item.Id就能提供当前父分类的ID。
2. AnQiCMS是否支持在不同内容模型（如文章模型和产品模型）之间进行分类嵌套？
AnQiCMS的分类设计中，每个分类都严格绑定到一个特定的内容模型。这意味着一个“文章分类”不能成为“产品分类”的子分类，