`tagList`标签如何调用文档的Tag列表？
内容运营的得力助手：安企CMS中tagList标签的巧妙运用
在内容浩瀚的互联网世界里，如何让信息高效组织、便于查找，并最终精准触达目标用户，是每一位内容运营者都在思考的问题。安企CMS（AnQiCMS）作为一个专为企业和自媒体设计的内容管理系统，深知这一痛点，并在其强大的模板标签体系中，提供了诸如tagList这样的得力工具，帮助我们轻松驾驭内容标签，为网站增添分类与聚合的魅力。
今天，我们就来深入探讨一下安企CMS中tagList标签的奥秘，看看它如何帮助我们灵活地调用文档的Tag列表，为网站内容的组织和呈现“画龙点睛”。
为什么内容标签如此重要？
在安企CMS中，标签（Tag）不仅仅是文档的关键词，它们更像是一座座桥梁，将不同分类、不同模型但主题相关的文档巧妙地连接起来。比如，一篇介绍“Go语言编程技巧”的文章和一篇关于“安企CMS二开教程”的文档，可能都会被打上“Go语言”或“开发”的标签。这种跨维度的关联，不仅能极大地提升用户在网站上的内容发现体验，还能优化搜索引擎的抓取和索引，助力网站的SEO表现。
安企CMS的后台提供了直观的标签管理界面，您可以为文档添加、编辑或删除标签，甚至可以为标签设置自定义URL、SEO标题和描述，让每一个标签都成为一个有价值的聚合页面。而要在前端页面展示这些精心设计的标签，tagList标签便是我们的不二之选。
tagList标签初探：基本用法
tagList标签是安企CMS模板引擎中用于获取文档标签列表的核心。它的使用方式沿袭了Django模板引擎的简洁风格，通过一对标签包裹内容并定义一个变量，即可轻松遍历并显示标签数据。
最基础的调用形式通常是这样的：
{% tagList tags with limit="10" %}
{% for item in tags %}
<a href="{{item.Link}}">{{item.Title}}</a>
{% endfor %}
{% endtagList %}
在这段代码中，tags是我们自定义的一个变量名，它会承载tagList标签获取到的所有标签数据，并以一个数组的形式返回。接着，我们通过for循环遍历这个tags数组，item变量在每一次循环中代表一个具体的标签对象。通过item.Link和item.Title，我们就能分别获取到标签的链接和标题，从而在页面上渲染出可点击的标签列表。
精准掌控：tagList标签的参数详解
tagList标签的强大之处在于其丰富的参数，允许我们根据不同的场景，精准地筛选和调用所需的标签列表。
itemId：文档ID的筛选魔术 这个参数决定了tagList要获取哪些文档的标签。如果我们在文档详情页调用tagList，通常不需要显式设置itemId，它会默认获取当前文档所关联的标签。但如果想获取指定文档的标签，只需传入该文档的ID，例如itemId="123"。 更值得一提的是，如果您想获取全站所有标签（比如在首页展示热门标签云），可以将itemId设置为"0"，这样tagList就不会自动绑定当前文档，而是从全局范围获取标签。limit：控制显示数量与分页limit参数用于控制tagList返回的标签数量。默认情况下，它最多显示10个标签，但您可以根据需要调整，例如limit="20"来显示20个标签。 对于更高级的用法，limit还支持“偏移量”模式，即limit="2,10"，表示从第2个标签开始，获取10个标签。这在实现一些特殊的标签布局时非常有用。categoryId：聚焦特定分类 当您希望只显示特定分类下的文档标签时，categoryId参数就派上用场了。您可以传入单个分类ID，如categoryId="1"，也可以传入多个分类ID，用英文逗号隔开，如categoryId="1,2,3"。这让您能够为不同的分类页面展示其专属的标签聚合。letter：按首字母筛选 如果您需要创建一个按字母顺序排列的标签导航（例如，一个A-Z的索引页），letter参数能让您只获取特定首字母开头的标签。其值范围为A-Z，如letter="A"。siteId：多站点环境下的应用 对于使用安企CMS多站点管理功能的用户，siteId参数允许您调用其他站点的数据。通常情况下，如果您只管理一个站点，无需填写此参数。
标签对象的可用字段
当您通过for循环遍历tagList返回的标签对象（即item）时，可以访问以下常用字段来展示标签信息：
Id：标签的唯一ID。Title：标签的显示名称，也是我们最常使用的字段。Link：标签的详情页链接，点击后会跳转到该标签下聚合的文档列表页面。Description：标签的描述信息，可能用于标签页面的SEO描述。FirstLetter：标签名称的首字母。CategoryId：如果标签与特定分类关联，此处会显示分类ID。
实践出真知：tagList的灵活运用场景
让我们通过几个实际的场景，来感受tagList标签的强大与便捷：
场景一：在文章详情页显示相关标签
在文章底部展示与当前文章相关联的标签，引导用户发现更多感兴趣的内容。
<div class="article-tags">
<span>相关标签：</span>
{% tagList tags %} {# 在文档详情页，无需指定itemId，默认获取当前文档标签 #}
{% for item in tags %}
<a href="{{item.Link}}" class="tag-item">{{item.Title}}</a>
{% endfor %}
{% endtagList %}
</div>
场景二：在侧边栏显示全站热门标签云
在网站的侧边栏或页脚，展示最受欢迎或最新的全站标签，吸引用户点击。
<div class="hot-tags-cloud">
<h3>热门标签</h3>
{% tagList hotTags with itemId="0" limit="20" %} {# itemId="0"表示获取全站标签 #}
{% for item in hotTags %}
<a href="{{item.Link}}" class="hot-tag-link">{{item.Title}}</a>
{% endfor %}
{% endtagList %}
</div>
场景三：创建标签列表页（Tag Index Page）并实现分页
如果您的网站有专门的标签索引页（例如：/tags），并希望分页展示所有标签，那么需要在tag/index.html模板中使用type="page"参数，并配合pagination标签。
{# 假设这是 tag/index.html 模板文件 #}
<div class="tag-list-container">
<h1>所有标签</h1>
{% tagList tags with type="page" limit="20" %} {# type="page"开启分页模式 #}
<ul>
{% for item in tags %}
<li><a href="{{item.Link}}">{{item.Title}}</a> ({{item.Description}})</li>
{% empty %}
<li>暂无标签</li>
{% endfor %}
</ul>
{% endtagList %}
{# 结合分页标签显示页码 #}
<div class="pagination-controls">
{% pagination pages with show="5" %}
{# 这里是分页的HTML结构，例如首页、上一页、数字页码、下一页、尾页 #}
<a class="{% if pages.FirstPage.IsCurrent %}active{% endif %}" href="{{pages.FirstPage.Link}}">首页</a>
{% if pages.PrevPage %}
<a href="{{pages.PrevPage.Link}}">上一页</a>
{% endif %}
{% for pageItem in pages.Pages %}
<a class="{% if pageItem.IsCurrent %}active{% endif %}" href="{{pageItem.Link}}">{{pageItem.Name}}</a>
{% endfor %}
{% if pages.NextPage %}
<a href="{{pages.NextPage.Link}}">下一页</a>
{% endif %}
<a class="{% if pages.LastPage.IsCurrent %}active{% endif %}" href="{{pages.LastPage.Link}}">尾页</a>
{% endpagination %}
</div>
</div>
通过这些灵活的参数组合，tagList标签能够满足您在不同页面上展示文档标签的各种需求，无论是展示单个文档的关联标签，还是构建全站的标签索引，都能游刃有余。
结语
安企CMS