在AnQiCMS模板中，如何使用`for`循环遍历`pageList`标签返回的所有单页面？

在AnQiCMS的世界里，内容的灵活性和高效管理是其核心优势。无论是发布企业新闻、产品详情，还是构建多站点的复杂内容矩阵，AnQiCMS都能提供强大而直观的支持。今天，作为一位深谙其道的运营专家，我想和大家聊聊在AnQiCMS模板制作中一个非常实用的技巧：如何巧妙运用for循环标签，来遍历并展示pageList标签返回的所有单页面内容。

AnQiCMS的单页面：灵活的内容基石

首先，让我们简单回顾一下AnQiCMS中的“单页面”功能。在后台，我们可以轻松创建和管理各种独立的页面，例如“关于我们”、“联系方式”、“服务详情”或者任何其他需要单独展示、内容相对固定的页面。这些单页面不仅支持自定义URL、SEO标题、关键词和描述，还能设置独立的模板和Banner图，极大地丰富了网站内容的表现形式。它们是构建网站基础信息和核心业务介绍不可或缺的组成部分。

然而，仅仅在后台创建了这些页面还不够，我们更需要将它们动态地呈现在网站前台，比如作为导航菜单的一部分，或者在某个区域集中展示所有服务页面。这时，AnQiCMS强大的模板标签和循环控制就派上了用场。

核心标签：pageList——获取所有单页面数据

要遍历单页面，我们首先需要将这些页面的数据提取出来。AnQiCMS为此提供了一个专门的模板标签——pageList。它的使用非常直接和简洁。

当你在模板中写入{% pageList pages %}时，系统就会自动获取所有已创建的单页面数据，并将它们存储在一个名为pages的变量中。这个pages变量是一个数组对象，每一个元素都代表着一个单页面的完整信息。pageList标签本身不需要复杂的参数配置，默认即可获取全站所有单页面，这为我们后续的遍历操作奠定了坚实的基础。当然，如果你在多站点环境下，并且需要获取特定站点的数据，pageList也支持通过siteId参数进行指定，但对于多数情况，默认用法已经足够。

每个单页面（在循环中我们通常称之为item）都承载着丰富的字段信息，比如Id（单页面ID）、Title（标题）、Link（页面链接）、Description（描述）、Content（页面内容）、Logo（缩略图大图）以及Thumb（缩略图）等。这些字段能够让我们在前端模板中灵活地展示页面的各个方面。

高效迭代：for循环遍历pageList数据

一旦pageList将单页面数据填充到pages变量中，我们就可以请出AnQiCMS模板中另外一个非常强大的标签——for循环。for循环标签专门用于遍历数组、切片或其他可迭代对象，让我们可以逐一访问pages变量中的每一个单页面，并将其内容呈现在网页上。

最基本的for循环语法如下：

{% pageList pages %}
    {% for item in pages %}
        {# 在这里可以访问item的各种属性 #}
        <h3><a href="{{ item.Link }}">{{ item.Title }}</a></h3>
        <p>{{ item.Description }}</p>
    {% endfor %}
{% endpageList %}

在这段代码中，item是每次循环中代表当前单页面的临时变量。通过item.Title、item.Link等形式，我们就能轻松地获取并展示每个单页面的标题和链接。

进阶运用与考量

在实际项目开发中，我们往往需要更精细的控制和更丰富的展示效果。AnQiCMS的for循环标签提供了多方面的辅助功能，让模板开发更加得心应手。

1. 处理空列表：{% empty %}的优雅回退 如果pageList没有返回任何单页面，我们不希望页面留白或出现错误。这时，for循环的{% empty %}分支就显得尤为重要。它允许我们在数据为空时提供一个友好的提示：

   {% pageList pages %}
       {% for item in pages %}
           {# ... 展示单页面内容 ... #}
       {% empty %}
           <p>目前还没有任何单页面内容发布。</p>
       {% endfor %}
   {% endpageList %}
   

2. 循环辅助变量：掌握每一次迭代 在for循环内部，AnQiCMS提供了一些内置的循环辅助变量，能够帮助我们更好地控制内容的展示逻辑：

   • forloop.Counter：表示当前循环的索引，从1开始计数。非常适合用于给列表项编号。
   • forloop.Revcounter：表示剩余的循环次数。 这些变量能够帮助我们实现更复杂的布局或样式控制，例如给第一个、最后一个或特定位置的元素添加独特的样式。

3. 条件判断：{% if %}的灵活筛选 有时，我们可能希望在遍历所有单页面时，排除某些特定的页面，或者根据页面的某个属性进行条件渲染。AnQiCMS的if逻辑判断标签可以很好地与for循环结合：

   {% pageList pages %}
       {% for item in pages %}
           {# 假设我们想排除ID为5的特定单页面 #}
           {% if item.Id != 5 %}
               <h3><a href="{{ item.Link }}">{{ item.Title }}</a></h3>
               {# ... 其他内容 ... #}
           {% endif %}
       {% empty %}
           <p>目前还没有任何单页面内容发布。</p>
       {% endfor %}
   {% endpageList %}
   

完整代码示例：动态展示所有服务页面

让我们结合上述技巧，构建一个更加完善的示例，在一个侧边栏中动态展示网站的所有服务页面：

”`twig