`{% tagDataList %}`标签如何获取特定Tag下的所有关联文档？
安企CMS 深度解析：如何巧用 {% tagDataList %} 标签精准聚合内容？
在内容运营的世界里，标签（Tag）是连接内容与用户的桥梁。它不仅能帮助我们更好地组织和归类海量信息，更能显著提升内容的发现效率和网站的SEO表现。对于安企CMS（AnQiCMS）的用户而言，充分利用其强大的标签功能，是实现内容精细化运营的关键一步。今天，我们就来深入探讨安企CMS中一个极为实用的模板标签——{% tagDataList %}，了解它如何帮助我们获取特定标签下的所有关联文档，从而构建出更具吸引力和用户价值的内容聚合页面。
标签，内容管理的智能索引
在安企CMS中，标签不仅仅是一个简单的关键词。它代表着一种灵活的内容关联机制，允许内容跨越传统的分类界限，根据主题、关键词或特性进行多维度聚合。从您在后台发布文档时为内容添加一个或多个Tag，到最终在前端页面将这些被打上相同Tag的文档智能地串联起来，安企CMS都提供了无缝且高效的支持。正如文档中提到的，安企CMS的“文档标签管理可以查看和管理所有的文档标签。文档标签不分分类和模型，同一个标签可以同时给不同的内容模型的文档标记”，这赋予了内容极大的灵活性和互联性。
{% tagDataList %}：标签内容的指挥家
当我们谈及如何获取特定标签下的所有关联文档时，{% tagDataList %} 标签无疑是这一任务的核心工具。它能够根据您指定的标签ID，筛选并返回所有与该标签关联的文档（AnQiCMS中通常称为“archive”）。这个标签的强大之处在于其灵活性和可控性，让您可以根据不同的业务需求，精准地展示内容。
让我们来详细解读 {% tagDataList %} 的使用方法和它的主要参数：
基本用法一瞥：
{% tagDataList archives with tagId="1" %}
{# 循环遍历文档内容 #}
{% endtagDataList %}
在这里，archives 是您自定义的一个变量名，用于存储 {% tagDataList %} 标签返回的文档列表。
核心参数详解，掌握内容获取的脉搏：
tagId：指定标签的唯一标识- 这是
{% tagDataList %}最核心的参数。当您处于一个标签的详情页面（例如tag/list.html或tag/index.html），安企CMS会智能地识别当前页面的Tag ID，此时您无需显式地传入tagId参数，标签会自动获取并使用当前页面的Tag ID来查询文档。 - 然而，如果您希望在其他页面，比如首页的某个模块、文章详情页的侧边栏，或者一个独立的专题页面，展示特定标签下的内容，就需要手动通过
tagId="[Tag ID]"来明确指定您想要获取内容的标签ID。比如，要获取ID为5的“市场营销”标签下的所有文档，您可以使用tagId="5"。
- 这是
moduleId：限定内容模型范围- 安企CMS支持灵活的内容模型，如“文章模型”（通常
moduleId="1"）和“产品模型”（通常moduleId="2"）等。如果您只想获取特定模型下的标签关联文档，可以使用moduleId="[模型ID]"进行筛选。例如，moduleId="1"将只返回“文章模型”下的文档，确保内容的精确性。
- 安企CMS支持灵活的内容模型，如“文章模型”（通常
order：定义内容的排序方式- 内容的呈现顺序对用户浏览体验至关重要。
order参数允许您自定义文档的排序规则。常见的排序方式包括：order="id desc"：按照文档ID降序排列，通常意味着最新发布的文档排在前面。order="views desc"：按照文档的浏览量降序排列，显示最受欢迎的文档。order="sort desc"：按照后台自定义的排序值降序排列，让您可以手动调整重要内容的优先级。
- 内容的呈现顺序对用户浏览体验至关重要。
limit：控制显示文档的数量- 这个参数用于限制每次查询返回的文档数量。例如，
limit="10"将只显示10条文档。 - 值得一提的是，
limit还支持“偏移模式”，即limit="[起始偏移量],[数量]"。例如，limit="2,10"表示从第2条文档开始（索引从0开始），获取接下来的10条文档，这在某些特殊布局中非常有用。
- 这个参数用于限制每次查询返回的文档数量。例如，
type：切换列表的呈现类型type参数定义了列表的呈现方式。type="list"是默认值，它会直接返回limit参数指定数量的文档列表。type="page"则表示您希望构建一个分页的文档列表。当使用type="page"时，您还需要结合安企CMS的{% pagination %}标签来渲染分页导航，为用户提供更好的浏览体验。
siteId：多站点环境下的数据隔离- 对于部署了多个站点的安企CMS用户，
siteId参数可以确保您能够跨站点调用或限定在当前站点内调用数据。一般情况下，如果您只管理一个站点，无需填写此参数，系统会默认处理。
- 对于部署了多个站点的安企CMS用户，
遍历文档对象，提取所需信息：
{% tagDataList %} 标签会将获取到的文档集合作为一个数组对象（我们将其命名为 archives）返回。在标签内部，您可以使用 {% for item in archives %} 循环来逐一处理每个文档对象。每个 item 都代表一个独立的文档，并包含了丰富的字段信息，如：
item.Id：文档IDitem.Title：文档标题item.Link：文档链接item.Description：文档简介item.Logo或item.Thumb：文档封面图或缩略图item.CreatedTime：文档发布时间（通常需要配合{{stampToDate(item.CreatedTime, "2006-01-02")}}进行格式化）item.Views：文档浏览量item.CategoryId：文档所属分类ID
等等，您可以根据实际需求灵活调用。
实践演练：一个典型的Tag列表页模板示例
假设我们正在构建一个Tag详情页面 tag/list.html，希望展示该Tag下的所有文章，并支持分页。下面是一个精简但功能完整的示例代码：
”`twig {# 页面TDK设置，确保SEO友好 #} {% tdk seoTitle with name=“Title” siteName=true %} {% tdk seoKeywords with name=“Keywords” %} {% tdk seoDescription with name=“Description” %} <!DOCTYPE html>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>{{ seoTitle }}</title>
<meta name="keywords" content="{{ seoKeywords }}">
<meta name="description" content="{{ seoDescription }}">
<link rel="stylesheet" href="{% system with name='TemplateUrl' %}/css/style.css">
{# 引入公共头部 #}
{% include "partial/header.html" %}
<div class="container">
{# 面包屑导航，提升用户体验 #}
{% breadcrumb crumbs %}
<nav class="breadcrumb">
{% for item in crumbs %}
<a href="{{ item.Link }}">{{ item.Name }}</a>
{% if not forloop.Last %} > {% endif %}
{% endfor %}
</nav>
{% endbreadcrumb %}
<h1 class="tag-title">标签：{% tagDetail with name="Title" %}</h1>