`tag-pageList`循环单页面时，如何跳过特定`Id`的页面不显示？

巧妙掌控内容显示：安企CMS tag-pageList 循环中跳过特定页面

作为一名资深的网站运营专家，我深知内容管理系统的灵活性对于运营效率和用户体验至关重要。安企CMS（AnQiCMS）以其基于Go语言的高性能架构和丰富的功能，为我们提供了强大的内容管理能力。在日常运营中，我们经常会遇到需要对内容进行精细化控制的场景，比如在某个页面列表循环中，我们需要跳过或不显示某些特定的页面。今天，我们就来深入探讨一下，在使用tag-pageList标签循环展示单页面内容时，如何巧妙地跳过特定Id的页面，以满足多样化的内容呈现需求。

为什么我们需要跳过特定页面？

在安企CMS中，pageList标签能够方便地将我们后台创建的“单页面”内容（例如“关于我们”、“联系方式”、“隐私政策”等）罗列出来。这些单页面对于网站的基础信息建设至关重要，但并非所有场景都适合将其全部展示。

举例来说，您可能有一个“所有页面”的导航菜单，希望列出大部分通用单页，但某些特殊的、内部使用的、或者不希望被用户直接通过列表访问的页面（比如一个测试页面、一个临时活动页面，或者一个只通过特定入口访问的法律声明页面）就不应该出现在这个列表中。此时，如果pageList标签没有提供直接的“排除ID”参数，我们就需要借助AnQiCMS模板引擎的强大逻辑控制能力来实现这一目标。

AnQiCMS的解决方案：循环内的条件判断

安企CMS的模板引擎支持Django模板语法，这意味着我们可以在循环遍历pageList获取到的数据时，利用if条件判断标签来筛选并排除不符合我们要求的页面。这种方法提供了一种极为灵活且强大的内容控制机制。

首先，让我们回顾一下pageList标签的基本用法。它会获取后台所有的单页面内容，并将其封装成一个可供我们遍历的数组对象。

<ul>
{% pageList pages %}
    {% for item in pages %}
    <li>
        <a href="{{ item.Link }}">{{ item.Title }}</a>
    </li>
    {% endfor %}
{% endpageList %}
</ul>

这段代码会列出所有单页面的标题和链接。现在，假设我们想要跳过Id为1的“关于我们”页面，以及Id为5的“隐私政策”页面，不让它们出现在这个列表中。我们可以在for循环内部，利用if条件判断标签和页面item对象的Id属性来实现。

item.Id是AnQiCMS为每个单页面自动生成的唯一标识符。我们可以通过比较这个Id，来决定是否显示当前循环中的页面。

为了让模板输出更加整洁，避免因为逻辑标签导致不必要的空行，我们还可以善用{%-和-{%这样的“移除逻辑标签占用行”的写法，它会智能地移除标签前后的空白符，让生成的HTML代码更紧凑。

跳过单个特定页面的示例：

如果我们只想跳过Id为1的页面，代码可以这样写：

<ul>
{% pageList pages %}
    {% for item in pages %}
        {%- if item.Id != 1 %}
        <li><a href="{{ item.Link }}">{{ item.Title }}</a></li>
        {%- endif %}
    {% endfor %}
{% endpageList %}
</ul>

在这个例子中，{%- if item.Id != 1 %}会检查当前循环到的页面item的Id是否不等于1。只有当条件为真时，<li>标签及其包含的页面标题和链接才会被渲染输出。

跳过多个特定页面的示例：

如果您需要跳过多个不连续的页面，比如Id为1和5的页面，我们可以使用逻辑运算符and将多个条件连接起来：

<ul>
{% pageList pages %}
    {% for item in pages %}
        {%- if item.Id != 1 and item.Id != 5 %}
        <li><a href="{{ item.Link }}">{{ item.Title }}</a></li>
        {%- endif %}
    {% endfor %}
{% endpageList %}
</ul>

这样，只有当item.Id既不等于1，也不等于5时，页面才会被显示。

更灵活的排除方式：使用contain过滤器排除列表中的ID

当需要排除的页面ID较多时，使用and item.Id != X的方式可能会让代码显得冗长。AnQiCMS提供了contain过滤器，结合list过滤器，可以更优雅地处理这种情况。我们可以先定义一个包含所有需要排除ID的列表，然后判断当前页面的Id是否在这个列表中。

{% set excluded_ids = '[1, 5, 8, 12]'|list %} {# 定义一个包含要排除ID的列表 #}
<ul>
{% pageList pages %}
    {% for item in pages %}
        {# 检查当前页面ID是否不在排除列表中 #}
        {%- if not (excluded_ids|contain:item.Id) %}
        <li><a href="{{ item.Link }}">{{ item.Title }}</a></li>
        {%- endif %}
    {% endfor %}
{% endpageList %}
</ul>

在这个更高级的示例中，我们首先使用{% set excluded_ids = '[1, 5, 8, 12]'|list %}定义了一个名为excluded_ids的数组，其中包含了所有我们希望跳过的页面ID。然后，在循环内部，not (excluded_ids|contain:item.Id)这行代码判断item.Id是否存在于excluded_ids列表中。如果item.Id不在这个列表中，那么当前页面就会被正常显示。这种方式在需要排除的ID数量较多时，能够显著提高模板代码的清晰度和可维护性。

实际应用场景与**实践

这种在pageList循环中通过条件判断来跳过特定页面的方法，在实际运营中有着广泛的应用：

• 精简导航与内容聚合： 在网站的页脚、侧边栏或某个专题页面中，您可能只需要展示部分精选或重要的单页面，而避免显示所有页面，保持界面的清爽和用户聚焦。
• A/B测试或临时活动页： 对于一些正在进行A/B测试或临时推广的单页面，您可能不希望它们出现在常规的页面列表中，以免干扰测试结果或提前暴露信息。
• 内部管理或草稿页： 网站后台可能有一些尚未完善的草稿页面，或者仅供内部人员查看的管理页面，这些页面绝不能出现在面向公众的任何列表里。
• SEO优化： 某些单页面可能内容价值较低，或包含重复内容，不适合被搜索引擎大量收录，通过列表排除可以避免其在站点地图或其他聚合页中暴露，从而更有效地控制搜索引擎抓取。

通过灵活运用AnQiCMS模板引擎的条件判断能力，您能够对网站