如何处理当`archiveList`查询结果为空时，`pagination`标签不显示分页导航的需求？

作为一位资深的网站运营专家，我很乐意为您深入探讨安企CMS（AnQiCMS）在内容展示方面的精妙之处，特别是当列表内容为空时，如何精细化地控制分页导航的显示。这不仅关乎到页面美观，更直接影响用户体验和网站的专业度。

当archiveList查询结果为空时，如何优雅隐藏分页导航？AnQiCMS模板技巧解析

在内容管理系统中，列表页是用户浏览信息的核心入口。安企CMS凭借其高效、灵活的特点，为我们提供了archiveList这样的强大标签，用于轻松获取和展示各类文档内容。同时，pagination标签则负责为这些列表提供便捷的分页导航。然而，一个常见的运营场景是：当某个分类、搜索结果或筛选条件下的文档内容为空时，页面上如果依然显示一个孤零零的分页导航（比如“第 1 页 / 共 1 页”），无疑会显得多余且降低用户体验。

今天，我们就来深入探讨在AnQiCMS中，如何巧妙地处理archiveList查询结果为空时，让pagination标签也随之“隐身”的需求。

理解AnQiCMS的模板机制与核心标签

AnQiCMS的模板系统借鉴了Django模板引擎的语法，以其简洁和强大而著称。在内容列表页的开发中，我们主要会用到以下几个关键标签：

• archiveList: 这是内容列表的核心，用于从数据库中查询并展示文章、产品等各类文档。当其type参数设置为"page"时，它会同时准备好分页所需的数据。
• pagination: 这是一个专门用于渲染分页导航的标签。它会接收archiveList生成的分页数据，并将其转化为用户友好的“上一页”、“下一页”、“页码”等链接。
• for循环与empty块: for循环用于遍历archiveList返回的文档集合。其独特的{% empty %}块是处理列表为空情况的利器，当for循环没有数据可迭代时，empty块内的内容就会被渲染。
• if逻辑判断: if标签提供了条件判断的能力，允许我们根据特定条件决定某个代码块是否执行。

核心痛点：为何要隐藏分页？

想象一下，用户通过搜索进入了一个结果页，却发现没有任何匹配的内容。此时，页面上显示一行“抱歉，未找到相关内容”是合理的。但如果下方还跟着一个写着“首页 上一页 1 下一页 末页”的分页条，就显得非常不协调和多余了。这不仅占用宝贵的页面空间，还可能让用户感到困惑，甚至认为网站设计不够严谨。因此，当archiveList查询结果为空时，同步隐藏pagination，是提升用户体验、优化页面视觉的重要一环。

解决方案一：巧用 for empty 结构处理内容空缺

AnQiCMS的for循环标签提供了一个非常方便的empty块。当archiveList未能找到任何符合条件的内容时，{% empty %} 代码块便会启动，为我们提供了一个优雅地展示“无内容”提示的机会。

首先，我们通常会这样编写archiveList和for循环来展示内容：

{% archiveList archives with type="page" limit="10" %}
    {% for item in archives %}
        <div class="archive-item">
            <h2><a href="{{ item.Link }}">{{ item.Title }}</a></h2>
            <p>{{ item.Description }}</p>
            <span>发布日期：{{ stampToDate(item.CreatedTime, "2006-01-02") }}</span>
        </div>
    {% empty %}
        <div class="no-content-message">
            <p>抱歉，未找到任何相关内容。</p>
            <p>您可以尝试修改搜索词或浏览其他分类。</p>
        </div>
    {% endfor %}
    {# 默认情况下，pagination标签会紧随其后 #}
    <div class="pagination-container">
        {% pagination pages with show="5" %}
            {# 分页导航的代码，例如： #}
            <a href="{{ pages.FirstPage.Link }}">首页</a>
            {% if pages.PrevPage %}<a href="{{ pages.PrevPage.Link }}">上一页</a>{% endif %}
            {% for page in pages.Pages %}<a class="{% if page.IsCurrent %}active{% endif %}" href="{{ page.Link }}">{{ page.Name }}</a>{% endfor %}
            {% if pages.NextPage %}<a href="{{ pages.NextPage.Link }}">下一页</a>{% endif %}
            <a href="{{ pages.LastPage.Link }}">末页</a>
        {% endpagination %}
    </div>
{% endarchiveList %}

在上面的示例中，如果archives为空，页面会显示“抱歉，未找到任何相关内容。”。然而，pagination标签依然会尝试渲染。为了解决这个问题，我们需要更精确地控制pagination的显示时机。

解决方案二：精确控制 pagination 的显示时机

当archiveList以type="page"模式运行时，它不仅提供了archives列表，还会生成一个名为pages的对象，这个对象包含了所有与分页相关的信息，例如总条目数(TotalItems)、总页数(TotalPages)、当前页(CurrentPage)等。

即使archiveList查询结果为空，pages对象依然会存在，但它的TotalItems通常会是0，TotalPages会是1（表示只有一页，且是空页）。因此，我们可以在渲染pagination标签之前，增加一个条件判断，只有当总页数大于1时，才显示分页导航。

这是推荐且更完善的做法：

”`twig {# 使用archiveList获取文档和分页数据 #} {% archiveList archives with type=“page” limit=“10” %}

{# 先处理文档列表的显示 #}
{% for item in archives %}
    <div class="archive-item">
        <h3><a href="{{ item.Link }}">{{ item.Title }}</a></h3>
        <p>{{ item.Description }}</p>
        <span>发布日期：{{ stampToDate(item.CreatedTime, "2006-01-02") }}</span>
    </div>
{% empty %}
    <div class="no-content-message">
        <p>抱歉，未找到任何相关内容。</p>
        <p>您可以尝试修改搜索词或浏览其他分类。</p>
    </div>
{% endfor %}

{# 接着，在分页导航渲染前，进行条件判断 #}