在网站运营中，我们经常需要从文章列表中快速提取某些特定信息，例如网站首页可能需要展示最新的文章标题，或者在某些特殊模块中需要获取文章列表的第一个或最后一个条目的标题。安企CMS（AnQiCMS）凭借其灵活的模板引擎和丰富的过滤器功能，可以轻松实现这些需求。

AnqiCMS 的模板系统借鉴了 Django 等主流模板引擎的语法，允许开发者和运营人员通过简洁直观的标签和过滤器来处理数据和控制页面逻辑。过滤器是模板变量处理的重要组成部分，它们能够对变量进行转换、格式化或提取特定信息，语法通常表现为 {{ 变量 | 过滤器名称: 参数 }}。

核心工具：first 和 last 过滤器

在 AnqiCMS 提供的众多过滤器中，first 和 last 过滤器便是处理列表数据时的得力助手。

  1. first 过滤器： 顾名思义，first 过滤器用于从一个序列（如字符串、数组或列表）中提取它的第一个元素。如果应用于字符串，它会返回字符串的第一个字符；如果应用于数组或文章列表，它会返回列表中的第一个完整对象。
  2. last 过滤器： 与 first 过滤器相对，last 过滤器用于从序列中提取最后一个元素。同样，应用于字符串时返回最后一个字符，应用于数组或文章列表时则返回列表中的最后一个完整对象。

这两个过滤器极大地简化了我们定位和获取列表两端数据的工作，而无需手动循环遍历整个列表。

获取文章列表：archiveList 标签

要应用 first 和 last 过滤器，首先需要有一个文章列表作为操作对象。在 AnqiCMS 中，archiveList 标签是用于获取文章列表的核心工具。它可以根据分类ID、模块ID、排序方式和显示数量等多种条件来灵活地查询文章。

例如，我们可以通过以下方式获取最新的 10 篇文章，并将结果存储在一个名为 articles 的变量中：

{% archiveList articles with type="list" limit="10" order="id desc" %}
    {# 列表内容通常在这里循环显示，但为了获取首尾文章，我们只需获取列表本身 #}
{% endarchiveList %}

这里，type="list" 表示获取一个不分页的列表，limit="10" 限制了文章数量为 10 篇，order="id desc" 则确保我们获取到的是最新的文章。

实战演练：快速获取首尾文章标题

有了文章列表 articles 变量后，我们就可以结合 first 和 last 过滤器来获取所需信息了。

第一步：确保文章列表存在

在尝试获取列表中的文章之前，最好先检查 articles 变量是否为空，以避免在列表无内容时模板报错。

{% if articles %}
    {# 文章列表存在，可以继续操作 #}
{% else %}
    <p>当前没有任何文章。</p>
{% endif %}

第二步：应用 first 和 last 过滤器并获取标题

如果 articles 列表中有内容，articles|first 将返回列表中的第一篇文章对象，articles|last 则返回最后一篇文章对象。文章对象通常包含 Title（标题）、Link（链接）、Description（描述）等属性。我们只需通过点运算符（.）来访问这些属性即可。

例如，要获取第一篇文章的标题：

{% set firstArticle = articles|first %}
{% if firstArticle %}
    <h3>最新文章：<a href="{{ firstArticle.Link }}">{{ firstArticle.Title }}</a></h3>
{% endif %}

同样地，要获取最后一篇文章的标题：

{% set lastArticle = articles|last %}
{% if lastArticle %}
    <h3>最旧文章：<a href="{{ lastArticle.Link }}">{{ lastArticle.Title }}</a></h3>
{% endif %}

完整代码示例

将上述步骤整合起来，我们可以在模板中这样快速获取并展示文章列表的首篇和末篇标题：

{# 1. 获取最新发布的 10 篇文章列表 #}
{% archiveList articles with type="list" limit="10" order="id desc" %}
{% endarchiveList %}

{# 2. 检查文章列表是否存在内容 #}
{% if articles %}
    {# 获取列表中的第一篇文章对象 #}
    {% set firstArticle = articles|first %}
    {# 获取列表中的最后一篇文章对象 #}
    {% set lastArticle = articles|last %}

    <div class="article-summary">
        {% if firstArticle %}
            <p><strong>最新文章：</strong>
                <a href="{{ firstArticle.Link }}">{{ firstArticle.Title }}</a>
            </p>
        {% endif %}

        {% if lastArticle %}
            <p><strong>最早文章（此列表内）：</strong>
                <a href="{{ lastArticle.Link }}">{{ lastArticle.Title }}</a>
            </p>
        {% endif %}
    </div>

    {# 如果需要，这里可以继续循环显示完整的文章列表 #}
    <ul class="article-list">
        {% for article in articles %}
            <li><a href="{{ article.Link }}">{{ article.Title }}</a></li>
        {% endfor %}
    </ul>

{% else %}
    <p>抱歉，目前没有找到任何文章。</p>
{% endif %}

通过这种方式，我们可以在 AnqiCMS 模板中，仅仅使用几行简洁的代码，便能高效地从文章列表中获取到首篇文章或末篇文章的标题，这对于实现首页最新动态、特色内容展示或快速导航等功能，提供了极大的便利。它不仅让模板代码更易于维护，也提升了内容的展示灵活性。

常见问题 (FAQ)

Q1：除了标题，我还能获取文章的其他信息吗？例如链接或缩略图？ A1：当然可以。first 和 last 过滤器返回的是完整的文章对象。这意味着你可以通过点运算符（.）访问文章对象的任何可用属性，例如 {{ firstArticle.Link }} 用于获取链接，{{ firstArticle.Thumb }} 用于获取缩略图，{{ firstArticle.Description }} 用于获取描述等。只需根据 archiveList 标签文档中列出的 item 字段，替换 .Title 即可。

Q2：如果文章列表为空，使用 first 或 last 过滤器会报错吗？ A2：直接对空列表使用 first 或 last 过滤器通常不会直接报错，但返回的结果会是 nil（空值）。如果不对 nil 值进行检查而直接访问其属性（例如 {{ nil.Title }}），则可能会导致模板渲染错误。因此，强烈建议在使用 firstArticle 或 lastArticle 变量之前，先用 {% if firstArticle %} 或 {% if lastArticle %} 进行判断，确保变量中确实包含了一个有效的文章对象。

Q3：我在文章列表的循环内部可以使用 first 和 last 过滤器来判断当前文章是不是第一篇或最后一篇吗？ A3：在循环内部，例如 {% for article in articles %} 中，虽然理论上也可以对整个 articles 列表再次使用 first 或 last 过滤器进行比较，但这并不是最推荐的做法。更简洁和性能更高的方式是利用循环变量 forloop 提供的属性，如 {% if forloop.first %}（判断是否是循环中的第一篇文章）和 {% if forloop.last %}（判断是否是循环中的最后一篇文章）。first 和 last 过滤器更适用于在循环 之外 独立获取列表的首尾元素。