作为一名资深的网站运营专家，我很清楚在内容管理系统中，评论功能不仅能增加用户互动，更能为网站带来活跃度和内容丰富度。安企CMS（AnQiCMS）作为一个基于Go语言开发的高效内容管理系统，在提供强大评论功能的同时，也兼顾了模板制作的灵活性。今天，我们就来深入探讨如何在AnQiCMS中，利用commentList标签优雅地实现评论数据的分页显示。
AnQiCMS中，commentList标签如何实现评论数据的分页显示？
在当今的互联网环境中，用户生成内容（UGC）的重要性不言而喻。评论作为用户与网站内容互动的重要形式，能够显著提升网站的社区感和用户粘性。然而，当评论数量庞大时，若不加以合理管理和展示，页面加载速度、用户体验乃至服务器性能都会受到影响。为此，AnQiCMS提供了commentList标签，配合pagination标签，能够高效且灵活地实现评论数据的分页显示，确保即便面对海量评论，网站也能保持流畅的访问体验。
commentList标签：评论数据获取的核心
commentList标签是我们在AnQiCMS模板中获取评论数据的起点。它不仅能拉取评论内容，更关键的是，它能够以“分页模式”来获取数据，这为后续的分页显示奠定了基础。
要启用分页功能，commentList标签需要特别设置两个关键参数：
archiveId：这个参数指定了你想要获取评论的文档（文章、产品等）的ID。通常，在文档详情页，我们会通过archiveDetail标签来获取当前文档的ID，然后将其传递给commentList。例如，archiveId=archive.Id表示获取当前页面文档的评论。type="page"：这是开启分页模式的核心。当type设置为"page"时，commentList标签会智能地将评论数据按照当前页码和每页数量进行切割，并生成必要的分页信息，以供pagination标签使用。limit：用于设定每页显示评论的数量。例如，limit="10"表示每页显示10条评论。
当commentList标签以type="page"模式运行时，它会将评论数据存储在一个你可以自定义的变量中（例如，我们常命名为comments），这个变量是一个包含评论对象的数组，每个对象都包含了评论的ID、用户名、内容、发布时间、审核状态以及是否是回复等详细信息。
同时，它还会默默地准备好一个全局的“分页对象”，这个对象包含了总评论数、总页数、当前页码、首页、上一页、下一页、末页以及所有中间页码的链接信息，我们稍后会用pagination标签来访问它。
让我们先看看commentList标签的基本结构：
{% commentList comments with archiveId=archive.Id type="page" limit="10" %}
{% for item in comments %}
{# 在这里渲染每一条评论的具体内容 #}
<div>
<span>{{ item.UserName }}</span> 于
<span>{{ stampToDate(item.CreatedTime, "2006-01-02 15:04") }}</span> 评论道：
<p>{{ item.Content|safe }}</p>
{% if item.Parent %}
<blockquote>回复 {{ item.Parent.UserName }}：{{ item.Parent.Content|truncatechars:50|safe }}</blockquote>
{% endif %}
{% if item.Status != 1 %}
<p style="color: gray;">（评论正在审核中...）</p>
{% endif %}
<div class="comment-actions">
<a href="javascript:;" data-id="{{ item.Id }}" class="reply-btn">回复</a>
<a href="javascript:;" data-id="{{ item.Id }}" class="like-btn">点赞 ({{ item.VoteCount }})</a>
</div>
</div>
{% empty %}
<p>暂无评论，快来发表您的真知灼见吧！</p>
{% endfor %}
{% endcommentList %}
在上述代码中，archive.Id通常是我们在文档详情页通过archiveDetail标签（如{% archiveDetail archive with name="Id" %}）获取到的当前文档ID。我们还使用了stampToDate过滤器来格式化时间，|safe过滤器来确保评论内容中的HTML标签能够正确渲染，以及|truncatechars来截断回复内容，提高可读性。{% empty %}块则优雅地处理了没有评论时的情况。
pagination标签：构建用户友好的分页导航
仅仅获取评论数据还不够，用户还需要直观的分页导航来浏览不同页的评论。这时，pagination标签就派上用场了。pagination标签专门用于生成“首页”、“上一页”、“下一页”、“尾页”以及页码数字等导航链接。
pagination标签的常用参数包括：
show：控制在分页导航中显示的页码数量。例如，show="5"表示在当前页码前后共显示5个页码数字。
pagination标签会创建一个名为pages的对象（你可以自定义变量名），这个pages对象非常丰富，包含了所有与分页相关的状态和链接：
TotalItems：总评论数。TotalPages：总页数。CurrentPage：当前页码。FirstPage、PrevPage、NextPage、LastPage：这些都是对象，每个对象包含Name（如“首页”）和Link（对应的URL）。Pages：这是一个数组，包含了所有需要显示的中间页码对象，每个对象同样有Name、Link和IsCurrent（表示是否是当前页）。
下面是pagination标签与commentList标签配合使用的完整示例：
”`twig {# 假设这里已经通过 archiveDetail 标签获取到了当前文档的 archive.Id #} {# 例如：{% archiveDetail archive with name=“Id” %}{% set archiveId = archive %}{% endarchiveDetail %} #}