如何在非Tag页面通过`tagList`和`itemId`参数展示特定文档的Tag？

作为一名资深的网站运营专家，我深知在内容管理系统中，如何灵活地展示信息对于提升用户体验和网站SEO至关重要。安企CMS（AnQiCMS）凭借其强大的模板标签系统，为内容运营者提供了极大的自由度。今天，我们就来深入探讨一个非常实用的场景：如何在非标签聚合页面（例如文章详情页或列表页）上，精准地展示与特定文档关联的标签。

洞悉标签价值：不只是分类，更是关联的枢纽

在AnQiCMS中，标签（Tag）不仅仅是对内容的简单归类，它们更是连接不同内容、构建内部链接、引导用户发现相关信息的重要工具。当用户浏览一篇文档时，页面底部或侧边栏出现的与其内容高度相关的标签，能够有效激发用户的探索欲望，提升网站的PV（页面访问量）和用户停留时间，进而向搜索引擎传递积极的用户行为信号。

AnQiCMS的标签功能强大且易于管理。在后台，您可以为每篇文档添加一个或多个标签，并对这些标签进行统一的管理和SEO优化。通常，您会在AnQiCMS提供的Tag专用页面（如tag/index.html或tag/list.html）看到标签列表或某个标签下的文档列表。但真正的运营艺术在于，如何将这些标签的价值延伸到更广阔的非标签聚合页面。

核心机制：tagList标签与itemId参数的巧妙结合

AnQiCMS的模板标签体系非常完善，其中tagList标签专门用于获取和展示标签列表。它的基本用法是获取全站或指定分类的标签。然而，当我们需要它“识别”并展示某个具体文档的标签时，就需要引入一个关键参数：itemId。

这个itemId参数的强大之处在于，它允许您明确指定要获取哪个文档的标签。简而言之，itemId就像一个精确的指向器，告诉tagList：“请把这个ID所代表的文档的所有标签都给我展示出来。”

要成功使用itemId，核心在于获取到目标文档的唯一标识ID。在AnQiCMS模板体系中，获取文档ID通常非常直观。接下来，我们将通过具体的场景，为您演示如何灵活运用这一机制。

场景一：在文档详情页展示当前文档的标签

假设您正在构建一篇博客文章的详情页，希望在文章标题下方或内容结尾处，列出当前正在阅读的这篇文章所关联的所有标签。这时，当前文档的ID可以通过archiveDetail标签轻松获取。

首先，在您的文档详情模板文件（例如archive/detail.html或自定义的文档模板）中，您需要获取当前文档的ID。这可以通过以下AnQiCMS模板代码实现：

{# 首先，在文档详情页，获取当前文档的ID #}
{% archiveDetail currentArchiveId with name="Id" %}

{# 然后，使用这个ID作为tagList的itemId参数，展示相关标签 #}
<div class="document-tags">
    <span class="tags-label">相关标签：</span>
    {% tagList tags with itemId=currentArchiveId limit="10" %}
        {% for tagItem in tags %}
            <a href="{{ tagItem.Link }}" title="{{ tagItem.Title }}" class="tag-link">{{ tagItem.Title }}</a>
        {% empty %}
            <span class="no-tags">暂无相关标签</span>
        {% endfor %}
    {% endtagList %}
</div>

在这段代码中，我们首先利用archiveDetail标签，将当前文档的ID赋值给currentArchiveId这个变量。随后，我们将currentArchiveId传递给tagList的itemId参数。limit="10"则控制了最多显示10个标签，{% empty %}块则优雅地处理了文档没有标签的情况，确保页面不会出现空白或报错。最终，每个标签都会以其标题和链接的形式呈现出来，用户点击后即可跳转到该标签的聚合页面。

场景二：在文档列表循环中为每个文档展示其专属标签

在分类列表页或首页，您可能需要为每一个展示的文档项都列出其对应的标签。例如，在一个文章列表区域，每篇文章的简介下方都显示几个关联标签。在这种情况下，文档ID同样是可获取的。在archiveList循环中，每个文档项自身就包含了其ID，即item.Id。

请看以下AnQiCMS模板代码示例，它展示了如何在archiveList循环中，为每个文档动态加载并显示标签：

”`twig {# 假设这是一个文档列表的循环，例如在分类页或首页 #} {% archiveList archives with type=“page” limit=“5” %}

{% for docItem in archives %}
<div class="article-card">
    <h3><a href="{{ docItem.Link }}">{{ docItem.Title }}</a></h3>
    <p class="description">{{ docItem.Description }}</p>
    <div class="article-tags">
        <span class="tags-label">标签：</span>
        {# 为当前循环中的文档项（docItem）展示标签 #}
        {% tagList tagsForDoc with itemId=docItem.Id limit="5" %}
            {% for tag in tagsForDoc %}
                <a href="{{ tag.Link }}" class="tag-badge">{{ tag.Title }}</a>
            {% empty %}
                <span class="no-tags">无标签</span>
            {% endfor %}
        {% endtagList %}
    </div>
</div>
{% end