`pageList`标签如何获取所有单页面的列表并在前端展示？
作为一名深谙安企CMS(AnQiCMS)运营之道的资深人士，我深知内容在网站建设中的核心地位。单页面作为承载企业核心信息、服务介绍、联系方式等静态内容的基石，其有效展示对用户理解网站和企业形象至关重要。本文将详细阐述如何利用AnQiCMS内置的pageList标签，获取并灵活地在前端展示所有单页面内容。
掌握pageList标签，构建清晰的单页面导航与展示
在AnQiCMS中，单页面是网站结构的重要组成部分，常用于“关于我们”、“联系方式”、“服务条款”等不需要频繁更新且内容相对固定的页面。这些页面的管理在后台的“页面资源”模块中进行。为了在前端（如网站的底部导航、侧边栏或专门的“解决方案”列表）统一或分类展示这些单页面，AnQiCMS提供了一个强大而简洁的模板标签——pageList。
pageList标签的主要作用是获取所有已创建的单页面列表。与archiveList等标签不同，pageList的设计理念是全面获取，而不是基于复杂的筛选条件。这意味着它会返回您后台所有可见的单页面数据。如果您需要对这些页面进行进一步的筛选或排序，则需要在前端模板的循环逻辑中实现。
使用pageList标签的基本语法结构简洁明了：
{% pageList pages %}
{# 在这里循环展示每个单页面信息 #}
{% endpageList %}
在这里，pages是一个您可以自定义的变量名，它将承载从后台获取到的所有单页面对象数组。通过这个变量，您可以在{% pageList %}和{% endpageList %}标签之间使用for循环来遍历并渲染每个单页面的详细信息。
pageList标签目前支持一个可选参数siteId。这个参数主要用于多站点管理场景。如果您在AnQiCMS后台创建了多个站点，并且需要调用特定站点的单页面数据，可以通过siteId来指定。然而，对于大多数单站点运营者而言，这个参数通常无需填写，系统会自动获取当前站点的单页面列表。
在for循环中，每个单页面对象（通常命名为item）都包含了丰富的可供调用的字段，使您能够全面展示页面的各项属性：
Id：单页面的唯一标识符。Title：单页面的标题，通常是用户在页面上看到的主要名称。Link：单页面的访问链接。Description：单页面的简短描述，常用于SEO或列表摘要。Content：单页面的完整内容，通常包含HTML结构。Logo：单页面的缩略图大图地址。Thumb：单页面的缩略图地址。
前端展示实例：从基本列表到智能筛选
了解了pageList的基础用法和可用字段后，我们可以开始在前端进行实际的展示。以下是一些常见的应用场景和代码示例。
创建一个简单的单页面列表
最直接的应用是在网站的页脚或导航菜单中列出所有单页面。这可以通过一个简单的for循环实现：
<nav class="footer-nav">
<h3>重要链接</h3>
<ul>
{% pageList pages %}
{% for item in pages %}
<li><a href="{{ item.Link }}">{{ item.Title }}</a></li>
{% endfor %}
{% endpageList %}
</ul>
</nav>
这段代码会遍历所有单页面，为每个页面创建一个列表项，并显示其标题和链接。这对于快速构建网站的基础导航非常有效。
筛选和排除特定单页面
在实际应用中，您可能不希望所有单页面都显示在某个特定的列表中，例如，您可能有一个内部使用的单页面，或者某个页面只在特定条件下才显示。此时，您可以在for循环内部使用if条件进行筛选。例如，如果需要排除ID为1的“关于我们”页面和标题包含“隐私”的页面：
<div class="sidebar-links">
<h3>我们的服务</h3>
<ul>
{% pageList pages %}
{% for item in pages %}
{# 排除ID为1的页面，并且排除标题包含“隐私”的页面 #}
{% if item.Id != 1 and "隐私" not in item.Title %}
<li>
<a href="{{ item.Link }}" title="{{ item.Description }}">
{% if item.Thumb %}<img src="{{ item.Thumb }}" alt="{{ item.Title }}"/>{% endif %}
<span>{{ item.Title }}</span>
</a>
</li>
{% endif %}
{% endfor %}
{% endpageList %}
</ul>
</div>
这个例子不仅展示了如何排除特定页面，还演示了如何结合Thumb字段显示缩略图，并通过Description字段提供更多信息。
高级展示：自定义样式与布局
有时，您可能需要为某些特定的单页面应用独特的样式或布局。forloop.Counter和forloop.Revcounter等循环辅助变量在此时显得非常有用。forloop.Counter表示当前循环的索引（从1开始），forloop.Revcounter表示从末尾开始的索引。
<div class="special-pages-section">
{% pageList pages %}
{% for item in pages %}
<div class="page-card {% if forloop.Counter == 1 %}featured{% endif %}">
<h3><a href="{{ item.Link }}">{{ item.Title }}</a></h3>
{% if item.Logo %}<img src="{{ item.Logo }}" alt="{{ item.Title }}" class="page-logo"/>{% endif %}
<p>{{ item.Description|truncatechars:100 }}</p> {# 截取描述文字，保持简洁 #}
<a href="{{ item.Link }}" class="read-more">了解更多</a>
</div>
{% endfor %}
{% endpageList %}
</div>
在这个例子中，我们给列表中的第一个单页面添加了featured类，以便通过CSS为其定义特殊的展示效果。同时，Description字段通过truncatechars过滤器进行了截断，确保在卡片布局中文字不会过长。
内容创作与运营的考量
作为网站运营人员，在使用pageList标签时，我们还需要注意一些内容创作和运营方面的细节：
首先，页面标题和描述的填写在后台至关重要。pageList标签会直接获取这些信息并展示到前端，它们不仅影响用户体验，更是搜索引擎优化（SEO）的关键元素。确保每个单页面都有独特的、有吸引力的标题和简洁准确的描述。
其次，单页面的管理秩序。虽然pageList本身没有直接提供排序参数，但AnQiCMS后台“页面管理”中的“显示顺序”字段可以控制页面的默认排序。这意味着您在后台调整的顺序，通常也会反映在pageList的输出中，除非您在前端代码中进行了自定义的排序逻辑。
最后，要区分单页面与文章/产品的用途。pageList适用于静态信息页面的展示，而对于动态更新的博客文章、新闻或产品信息，应使用archiveList或categoryList等更专业的标签，因为它们提供了更丰富的筛选、排序和分页功能，以适应动态内容的特点。
通过合理运用pageList标签及其搭配的逻辑控制，您可以在AnQiCMS前端轻松构建出清晰、美观且功能实用的单页面展示模块，从而提升网站的信息架构和用户体验。
常见问题解答 (FAQ)
1. pageList标签可以获取单个指定ID的单页面吗？
pageList标签设计用于获取所有或经过循环筛选的单页面列表，它本身不直接支持通过ID获取单个单页面。如果您需要获取并展示某个特定ID的单页面详情，应该使用pageDetail标签，该标签允许您通过id或token参数精确指定需要获取的单页面。
2. 如何控制pageList标签获取的单页面的显示顺序？
pageList标签本身不提供order参数来直接控制排序。单页面的默认排序通常取决于您在AnQiCMS后台“页面管理”中设置的“显示顺序”。数字越小，显示越靠前。如果需要在前端实现更复杂的排序（例如按标题字母顺序），您需要将获取到的pages数据存储到一个变量中，然后在JavaScript或模板的自定义逻辑中对该变量进行排序。
3. pageList和archiveList有什么主要区别，何时使用它们？
pageList主要用于获取和展示单页面，这些页面通常是静态的、信息性内容，如“关于我们”、“联系方式”、“服务条款”等，它们的更新频率较低，且没有分类、标签等复杂结构。而archiveList则用于获取和展示文章、产品等动态内容，它们通常属于特定的内容模型（如文章模型、产品模型），可以有分类、标签、评论、自定义字段等，并支持更丰富的筛选、排序和分页功能。简而言之，pageList处理静态固定内容，archiveList处理动态结构化内容。