AnQiCMS模板中如何判断变量是否为空或执行条件逻辑？

作为一位资深的网站运营专家，我深知在构建和维护一个高效、用户友好的网站时，模板逻辑的精准控制是多么关键。尤其在使用像安企CMS（AnQiCMS）这样基于Go语言、注重性能和灵活性的内容管理系统时，能够灵活判断变量状态，并根据不同情况执行条件逻辑，是确保内容展示正确、避免页面报错、提升用户体验的基石。

安企CMS的模板引擎采用了类似Django语法的标记方式，这让熟悉Web开发的运营者和开发者都能快速上手。它提供了直观且强大的条件判断与循环控制能力，帮助我们轻松应对各种内容展示场景。今天，我们就来深入探讨在AnQiCMS模板中，如何判断变量是否为空或执行复杂的条件逻辑。

AnQiCMS模板中的条件判断基础：if 标签的妙用

在AnQiCMS的模板世界里，最核心的条件判断工具无疑是{% if %}标签。它的语法简洁而强大，能够帮助我们根据变量的布尔值来决定是否渲染特定的内容块。

一个变量在AnQiCMS模板引擎中，当它为 nil（空值）、false（布尔假）、数字 0、空字符串 "" 或是空集合（如空数组、空切片、空字典/map）时，都会被{% if %}标签判断为“假”（falsy）。这意味着，我们无需显式地去写 {% if variable == nil %} 或 {% if variable == "" %}，直接使用 {% if variable %} 就能非常优雅地判断变量是否有实际内容。

让我们看几个常见的例子来理解这一点：

  • 判断字符串是否为空：

    {% if archive.Title %}
  <h1>{{ archive.Title }}</h1>
{% else %}
  <h1>暂无标题</h1>
{% endif %}

    这里，如果archive.Title有任何非空字符串值，标题就会显示；否则，将显示“暂无标题”。

  • 判断列表或集合是否为空： 假设category.Images是一个图片列表：

    {% if category.Images %}
  <div class="banner">
      {% for img in category.Images %}
          <img src="{{ img }}" alt="分类图片">
      {% endfor %}
  </div>
{% else %}
  <p>此分类暂无图片展示。</p>
{% endif %}

    如果category.Images中包含图片，它会被渲染出来；如果为空列表，则会显示提示信息。

  • 判断布尔值或数字： 例如，从后台系统设置中获取网站是否处于关闭状态：

    {% if system.SiteStatus == 0 %} {# 假设0代表开启，非0代表闭站 #}
  <p>网站正在正常运行。</p>
{% else %}
  <p>网站已暂停访问：{{ system.SiteCloseTips }}</p>
{% endif %}

    我们也可以利用{% elif %}（else if）和{% else %}来构建更复杂的条件链，以应对多重业务逻辑：

    {% if user.IsVIP %}
  <p>欢迎VIP会员，尊享专属内容！</p>
{% elif user.TotalReward > 100 %}
  <p>您的累计收益已超过100元，快升级VIP解锁更多权益！</p>
{% else %}
  <p>您是普通会员，查看更多精彩内容！</p>
{% endif %}

优雅处理空集合：for 循环的 empty 标签

在处理列表、数组这类集合数据时，我们经常需要判断它们是否包含元素。如果集合为空，我们可能需要显示一条“暂无内容”的提示。AnQiCMS的模板引擎为{% for %}循环提供了一个非常实用的{% empty %}标签，让这个场景的处理变得格外简洁和优雅。

例如，当我们需要展示一篇文档的相关文章列表时：

{% archiveList archives with type="related" limit="5" %}
    <div class="related-articles">
        <h3>相关推荐</h3>
        <ul>
            {% for item in archives %}
                <li><a href="{{ item.Link }}">{{ item.Title }}</a></li>
            {% empty %}
                <li>暂无相关文章推荐。</li>
            {% endfor %}
        </ul>
    </div>
{% endarchiveList %}

如果archives列表中有文章，{% for %}循环会正常遍历并显示它们；如果列表为空，{% empty %}标签内的内容就会被渲染出来，完美避免了额外的{% if archives %}判断。这不仅让模板代码更简洁，也提升了网站的健壮性。

巧用过滤器：为变量提供默认值或进行高级判断

AnQiCMS的模板过滤器（Filters）是处理变量、格式化输出的强大工具，其中一些对于判断变量状态或提供备用内容尤其有用。

  1. default 和 default_if_none 过滤器：提供备用内容 当某个变量可能为空或不存在时，我们希望能够提供一个默认值来代替，而不是让页面显示空白或报错。

    • default 过滤器会在变量被评估为“假”（如空字符串、0、false）时提供默认值。
    • default_if_none 过滤器则更严格，只在变量确实是 nil（或者Go语言中的nil类型）时才提供默认值，而不会对空字符串或0起作用。

    例如，显示文章描述，如果为空则显示“点击查看详情”：

    <p>{{ archive.Description|default:"点击查看详情" }}</p>

    如果archive.Description为空字符串或nil，它将显示“点击查看详情”。

    假设user.Phone是一个可能为nil的字段，而不是空字符串：

    <p>联系电话：{{ user.Phone|default_if_none:"未提供" }}</p>

  2. length 过滤器：检查字符串或集合长度 length 过滤器可以方便地获取字符串的字符数或集合（如数组、切片、map）的元素数量。这在需要精确判断长度而非仅仅判断“真假”时非常有用。

    {% if archive.Content|length > 100 %}
    <p>文章内容很长，请耐心阅读。</p>
{% else %}
    <p>文章内容较短。</p>
{% endif %}

    这里，我们判断文章内容字符串的长度是否超过100个字符。

  3. contain 过滤器：判断是否包含特定内容 如果你需要判断一个字符串是否包含某个子字符串，或者一个数组中是否包含某个元素，contain 过滤器就能派上用场。

    {% if archive.Content|contain:"SEO" %}
    <p class="tag">本文包含SEO相关内容。</p>
{% endif %}

    如果文章内容中包含“SEO”这个词，就会显示相应的提示。

  4. yesno 过滤器：语义化布尔输出 yesno 过滤器可以将布尔值或可评估为布尔值的变量转化为更具语义的文本输出。它可以接受最多三个参数，分别对应“真”、“假”和“未知/nil”时的显示文本。

    <p>审核状态：{{ archive.Status|yesno:"已发布,待审核,未设置" }}</p>

    如果archive.Status为true（例如1），显示“已发布”；为false（例如0），显示“待审核”；如果为nil，则显示“未设置”。

实战演练：综合运用判断逻辑

让我们通过一个稍微复杂点的场景来演示如何综合运用这些判断逻辑。假设我们正在构建一个产品详情页，需要根据产品的不同属性来显示内容：

”`twig 

<h1>{{ archive.Title|default:"产品名称待定" }}</h1>

{%- if archive.Logo %}
    <div class="product-image">
        <img src="{{ archive.Logo }}" alt="{{ archive.Title }}">
    </div>
{%- elif archive.Images %}
    <div class="product-gallery">
        {%- for img in archive.Images %}
            <img src="{{ img }}" alt="产品图">
        {%- empty %}
            <p>产品图片正在上传中...</p>
        {%- endfor %}
    </div>
{%- else %}
    <div class="no-image-placeholder">
        <p>暂无产品图片。</p>
    </div>
{%- endif %}

<div class="product-