您好！作为一位资深的网站运营专家，我很乐意为您深入解析如何在AnQiCMS中巧妙地结合commentList和pagination标签，实现评论内容的分页展示，让用户互动更加流畅有序。
在当今内容为王的时代，用户评论不仅是网站活力的象征，更是内容价值的重要体现。然而，如果一篇热门文章积累了海量评论，一次性全部加载无疑会给页面带来巨大的负担，严重影响用户体验。此时，将评论进行分页展示就显得尤为重要，它能让页面保持轻量，同时确保用户可以按需浏览历史评论。
AnQiCMS作为一款高效、灵活的内容管理系统，提供了强大的模板标签功能，其中commentList和pagination标签正是解决此问题的黄金搭档。
核心搭档一：commentList标签——评论数据的捕手
首先，我们需要用commentList标签来获取指定文档的评论数据。这个标签就像一个评论数据的“捕手”，它能根据我们的需求，从数据库中抓取相关的评论记录。
在使用commentList时，有几个关键参数需要您留意：
archiveId：这是指定评论所属文档（如文章、产品）的ID。在一个文章详情页中，我们通常会通过archiveDetail标签来获取当前文章的ID，然后将这个ID传递给commentList。例如，如果您已经通过{% archiveDetail archive %}获取了当前文档的信息，那么archive.Id就是您需要的文档ID。type="page"：这是实现分页展示的核心。当您将type参数设置为"page"时，commentList标签将不仅返回评论数据，还会自动生成与分页相关的元数据，为后续pagination标签的工作打下基础。limit：这个参数用于控制每页显示多少条评论。例如，limit="10"意味着每页将显示10条评论。
当commentList标签以type="page"的形式被调用时，它会返回一个包含评论列表（comments）以及页面总数、当前页码等信息的对象。评论列表中的每个item都包含了评论的详细信息，比如评论ID（Id）、评论者用户名（UserName）、评论内容（Content）、发布时间（CreatedTime）以及审核状态（Status）等。值得注意的是，为了保障网站内容的健康，我们通常只展示Status为1（已审核通过）的评论。
核心搭档二：pagination标签——分页导航的舵手
有了commentList标签返回的评论数据和分页元数据，pagination标签就可以登场了。它如同一个“分页导航的舵手”，能够根据commentList提供的分页信息，自动生成美观且功能完整的分页链接。
pagination标签的主要参数是：
show：这个参数控制着分页导航中，除了“首页”、“上一页”、“下一页”、“末页”之外，中间区域连续显示多少个页码按钮。例如，show="5"表示中间会显示5个页码。
pagination标签会返回一个pages对象，其中包含了如TotalItems（评论总数）、TotalPages（总页数）、CurrentPage（当前页码）以及FirstPage（首页）、PrevPage（上一页）、NextPage（下一页）、LastPage（末页）等多个页面对象。每个页面对象（包括中间页码列表Pages中的item）都包含Name（显示名称，如页码数字）、Link（对应页面的URL）和IsCurrent（布尔值，表示是否为当前页，可用于添加CSS样式）等属性。
强强联合：实现评论分页展示的步骤
现在，让我们把这两个标签结合起来，看看如何在您的模板中实现评论内容的分页展示：
获取当前文档ID：这是评论列表的锚点。通常在文档详情页，您可以直接从上下文中的
archive对象获取ID。{% archiveDetail archive %} {# 获取当前文档对象，将其命名为 archive #} {# 此时，archive.Id 就包含了当前文档的ID #}调用
commentList获取评论数据：我们将archive.Id传递给commentList，并设置type="page"和limit。{% 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> {% if item.Status == 1 %} {# 只显示审核通过的评论 #} <p>{{ item.Content|safe }}</p> {% else %} <p>评论正在审核中...</p> {% endif %} {# 如果评论有父评论（回复），可以显示父评论内容 #} {% if item.Parent %} <blockquote>回复 {{ item.Parent.UserName }}: {{ item.Parent.Content|truncatechars:50|safe }}</blockquote> {% endif %} </div> {% empty %} <p>目前还没有评论，快来发表您的看法吧！</p> {% endfor %} {% endcommentList %}调用
pagination生成分页导航：紧随commentList之后，pagination标签会自动识别并使用commentList生成的评论分页数据。<div class="pagination"> {% pagination pages with show="5" %} <ul> <li class="page-item {% if pages.FirstPage.IsCurrent %}active{% endif %}"> <a href="{{pages.FirstPage.Link}}">{{pages.FirstPage.Name}}</a> </li> {% if pages.PrevPage %} <li class="page-item"> <a href="{{pages.PrevPage.Link}}">{{pages.PrevPage.Name}}</a> </li> {% endif %} {% for item in pages.Pages %} <li class="page-item {% if item.IsCurrent %}active{% endif %}"> <a href="{{item.Link}}">{{item.Name}}</a> </li> {% endfor %} {% if pages.NextPage %} <li class="page-item"> <a href="{{pages.NextPage.Link}}">{{pages.NextPage.Name}}</a> </li> {% endif %} <li class="page-item {% if pages.LastPage.IsCurrent %}active{% endif %}"> <a href="{{pages.LastPage.Link}}">{{pages.LastPage.Name}}</a> </li> </ul> <p>共 {{ pages.TotalItems }} 条评论，{{ pages.TotalPages }} 页，当前第 {{ pages.CurrentPage }} 页。</p> {% endpagination %} </div>
将上述代码片段有机地组合在您的评论展示区域，您就能实现一个功能完善且用户友好的评论分页系统。请记住，在实际部署时，还需要根据您网站的整体风格，通过CSS对分页和评论列表进行美化。
完整代码示例
为了让您更好地理解，这里提供一个完整的代码结构，您可以在您的文档详情模板中进行参考和调整：
”`twig {# 假设这是您的文章详情页，并且已经通过路由获取了当前文档信息 #}
<h1>{{ archive.Title }}</h1>
<div class="article-content">
{{ archive.Content|safe }}
</div>
<section class="comments-section">
<h2>用户评论</h2>
{# 1. 调用 commentList 获取评论数据并标记为可分页 #}
{% commentList comments with archiveId=archive.Id type="page" limit="10" %}
<div class="comment-list">
{% for item in comments %}
{% if item.Status == 1 %} {# 确保只显示已审核通过的评论 #}
<div class="comment-item">
<