如何在模板中获取并循环输出特定Tag（标签）下的所有文档列表？

在安企CMS中，内容组织不仅可以通过传统的分类方式实现，灵活的“标签”（Tag）机制更是为内容关联和用户检索提供了广阔的空间。当您希望在网站的某个区域，例如侧边栏、相关推荐模块，甚至是一个专门的Tag聚合页面，展示特定标签下的所有文档时，安企CMS提供了强大而直观的模板标签，让这个过程变得轻而易举。

本文将深入探讨如何在安企CMS的模板中，通过简单的代码获取并循环输出特定Tag（标签）下的所有文档列表，帮助您更好地利用标签功能，提升网站内容的组织性和用户体验。

标签（Tag）在安企CMS中的作用

在安企CMS中，标签是一种灵活的内容组织工具。与严格的分类体系不同，标签可以跨越不同的内容模型（如文章、产品等）进行关联。这意味着一篇“安企CMS使用教程”的文章和一个“安企CMS培训服务”的产品，都可以被打上“安企CMS”这个标签。这种灵活性使得内容可以从多个维度被关联和发现，极大地丰富了网站的导航和SEO潜力。

核心武器：tagDataList 标签

要获取特定Tag下的文档列表，我们主要依赖安企CMS提供的 tagDataList 模板标签。这个标签专门用于从数据库中检索与特定标签关联的文档集合。

tagDataList 标签的基本结构

tagDataList 标签的使用遵循安企CMS模板引擎的通用语法，它需要一个变量名来承载获取到的文档列表，并在一对 {% tagDataList ... %} 和 {% endtagDataList %} 之间定义循环输出的逻辑。

基本语法如下：

{% tagDataList 变量名称 with 参数 %}
    {% for item in 变量名称 %}
        {# 在这里输出文档的各项信息 #}
    {% endfor %}
{% endtagDataList %}

其中，变量名称 可以是您自定义的任何名称，例如 archives、tagArticles 等。item 则是在 for 循环中代表每一篇文档的临时变量。

关键参数解析

tagDataList 标签支持多个参数，让您可以精细地控制获取哪些Tag下的哪些文档，以及如何排序和显示。

• tagId (必需)： 这是指定您想获取哪个Tag下文档的关键参数。您可以直接填写Tag的数字ID，例如 tagId="1"。如果您正在一个Tag详情页（例如 tag/list.html）使用此标签，并且希望获取当前页面Tag下的文档，则无需指定 tagId，它会自动读取当前页面的Tag ID。
• moduleId (可选)： 如果您只想获取某个特定模型（如文章模型、产品模型）下，与该Tag关联的文档，可以使用此参数。例如，moduleId="1" 表示只获取文章模型下的文档。
• type (可选)： 控制列表的显示方式。
  • type="list" (默认值)：按 limit 参数指定的数量显示文档，不带分页功能。
  • type="page"：