在安企CMS中，标签（Tag）是组织内容、提升SEO和用户体验的重要工具。有时，我们不仅需要列出标签，还需要在页面上展示某个特定标签的详细信息，例如它的描述、链接甚至是Logo。这时候，tagDetail 标签就派上了用场，它能帮助我们轻松地获取这些数据。
tagDetail 标签概述
tagDetail 标签的主要作用是获取单个 Tag 标签的详细信息。无论是在标签本身的详情页、列表页，还是在文档详情页中想关联显示某个标签的详细数据，tagDetail 都能提供灵活的调用方式。它的基本使用形式是这样的：
{% tagDetail 变量名称 with name="字段名称" id="标签ID" %}
其中：
变量名称是一个可选参数，如果你想将获取到的值存储到一个变量中，方便后续多次使用，就可以指定。如果不指定，tagDetail会直接输出结果。name="字段名称"是关键所在，它指定了你想要获取的 Tag 标签的某个具体属性，例如标题、链接、描述等。id="标签ID"或token="标签URL别名"也是可选参数。如果你当前所处的页面就是该 Tag 标签的页面（例如标签详情页），那么tagDetail会默认获取当前页面的 Tag 信息，无需指定id或token。但如果你想获取 非当前页面 的某个特定 Tag 信息，就可以通过id（Tag 的唯一数字 ID）或token（Tag 的 URL 别名）来精确指定。siteId参数用于多站点场景，如果你管理着多个站点并希望调用其他站点的数据，可以通过这个参数指定站点ID。一般情况下，你无需关心此参数。
接下来，我们来看看name参数可以获取哪些常用的标签信息。
详细字段解析与应用
tagDetail 标签通过 name 参数可以获取一系列与 Tag 相关的字段。了解这些字段以及如何调用它们，能让你在模板设计上拥有更大的自由度。
1. 标签ID (Id)
这是每个标签独一无二的数字标识符。
{# 获取当前页面的Tag ID #}
<div>当前标签ID：{% tagDetail with name="Id" %}</div>
{# 获取指定ID为1的Tag ID #}
<div>指定标签ID：{% tagDetail with name="Id" id="1" %}</div>
{# 将Tag ID存储到变量中 #}
{% tagDetail myTagId with name="Id" %}
<div>我的标签ID是：{{ myTagId }}</div>
2. 标签标题 (Title)
通常是标签的显示名称，也是最常用的信息之一。
{# 获取当前页面的Tag标题 #}
<h2>{% tagDetail with name="Title" %}</h2>
{# 获取指定ID为1的Tag标题 #}
<div>标签名称：{% tagDetail with name="Title" id="1" %}</div>
{# 将Tag标题存储到变量中 #}
{% tagDetail currentTagTitle with name="Title" %}
<h1>{{ currentTagTitle }}</h1>
3. 标签链接 (Link)
这是该标签详情页的URL地址，方便用户点击跳转到所有关联了该标签的内容列表。
{# 获取当前页面的Tag链接 #}
<p>查看更多相关内容：<a href="{% tagDetail with name="Link" %}">点击这里</a></p>
{# 获取指定ID为1的Tag链接 #}
<a href="{% tagDetail with name="Link" id="1" %}">查看指定标签内容</a>
{# 将Tag链接存储到变量中 #}
{% tagDetail tagUrl with name="Link" %}
<a href="{{ tagUrl }}">进入标签页面</a>
4. 标签描述 (Description)
用于简要介绍标签的用途或包含的内容，对SEO和用户理解都有帮助。
{# 获取当前页面的Tag描述 #}
<p>标签简介：{% tagDetail with name="Description" %}</p>
{# 获取指定ID为1的Tag描述 #}
<div>这是一个关于：{% tagDetail with name="Description" id="1" %}</div>
{# 将Tag描述存储到变量中 #}
{% tagDetail tagIntro with name="Description" %}
<p>{{ tagIntro }}</p>
5. 索引字母 (FirstLetter)
如果标签名称是英文，这个字段会返回其首字母（大写），方便按照字母顺序进行分类展示。
{# 获取当前页面的Tag首字母 #}
<span>标签首字母：{% tagDetail with name="FirstLetter" %}</span>
6. 标签图片 (Logo)
如果后台为标签设置了缩略图或 Logo，可以通过此字段获取其图片链接。
{# 获取当前页面的Tag Logo #}
<img src="{% tagDetail with name="Logo" %}" alt="{% tagDetail with name="Title" %}" />
{# 获取指定ID为1的Tag Logo #}
<img src="{% tagDetail with name="Logo" id="1" %}" alt="{% tagDetail with name="Title" id="1" %}" />
7. 标签内容 (Content)
这个字段可以存储更详细的标签介绍或相关信息，通常以富文本（HTML）或Markdown格式保存。
{# 获取当前页面的Tag内容，注意使用 |safe 过滤器防止HTML被转义 #}
<div class="tag-full-content">{% tagDetail with name="Content" render=true %|safe}</div>
{# 获取指定ID为1的Tag内容，并存储到变量中 #}
{% tagDetail specificTagContent with name="Content" id="1" render=true %}
<div class="specific-tag-details">{{ specificTagContent|safe }}</div>
请注意，当Content字段中包含HTML或Markdown内容时，建议使用|safe过滤器来确保内容能够被浏览器正确解析而不是作为纯文本显示。如果你的后台开启了Markdown编辑器，并且Content内容是Markdown格式，你还需要添加render=true参数，让系统在输出前将其转换为HTML。
实际应用示例
假设你正在为安企CMS搭建一个标签列表页面，或者在一个文档详情页的侧边栏中需要展示当前文档所属标签的详细信息。
场景一：在标签详情页面展示当前标签的详细信息
在 template/你的模板目录/tag/detail.html 或 tag/list.html（如果配置为Tag详情页），你可以这样调用：
<div class="tag-header">
<h1>{% tagDetail with name="Title" %}</h1>
<p class="tag-description">{% tagDetail with name="Description" %}</p>
{% tagDetail tagLogo with name="Logo" %}
{% if tagLogo %}
<img src="{{ tagLogo }}" alt="{% tagDetail with name="Title" %}" class="tag-logo">
{% endif %}
<div class="tag-content">
{% tagDetail tagFullContent with name="Content" render=true %}
{{ tagFullContent|safe }}
</div>
<a href="{% tagDetail with name="Link" %}" class="btn btn-primary">查看所有关联内容</a>
</div>
这个示例展示了如何在标签的专属页面上，直接获取并呈现该标签的标题、描述、Logo和详细内容，同时提供一个指向自身链接的按钮。
常见问题 (FAQ)
问：
tagDetail标签默认会获取哪个 Tag 的信息？ 答：如果你不提供id或token参数，tagDetail标签会智能地尝试获取当前页面所关联的 Tag 信息。例如，在 Tag 详情页（URL中包含Tag ID或别名），它会自动识别并显示当前 Tag 的数据。在文档详情页中，如果当前文档关联了Tag，tagDetail不会自动获取当前文档的Tag信息，你需要通过tagList获取标签列表后再循环调用tagDetail或者通过tagDetail的id参数指定。问：如何在文档详情页中展示当前文档所关联的某个 Tag 的详细信息？ 答：在文档详情页中，你首先需要使用
tagList标签来获取当前文档关联的所有 Tag 列表。然后，你可以遍历这个列表，对列表中的每个 Tag 使用tagDetail标签，通过tagDetail的id参数（传入item.Id）来获取每个 Tag 的具体信息。问：
Description和Content字段有什么区别？ 答：Description通常用于存储简短的标签简介，字数较少，主要用于列表展示、SEO元数据（<meta name="description">）等场景。而Content字段则可以存储更为详细、丰富的图文内容，可能包含HTML格式或Markdown格式，用于在标签详情页中作为正文展示。当调用Content字段时，如果其中包含HTML或Markdown，请务必使用|safe过滤器，并且在Markdown内容时加上render=true参数，以确保内容被正确解析显示。