AnQiCMS模板中如何进行最基本的条件判断，例如判断变量是否存在？

驾驭内容智慧：AnQiCMS模板中变量判断的艺术

在AnQiCMS构建的网站世界里，模板是内容的舞台，而如何让这个舞台上的元素根据不同条件智能地展现，便是每位运营专家和开发者需要掌握的核心技能。作为一款基于Go语言、且支持类似Django模板引擎语法的企业级内容管理系统，AnQiCMS提供了直观而强大的模板标签，其中最基础也最常用的，莫过于变量的条件判断，尤其是判断一个变量是否存在或是否有值。

想象一下，如果您的网站需要在一个文章详情页上展示作者头像，但有些文章可能没有设置；或者，一个产品列表页，您只想在有子分类时才显示下拉菜单。这些场景都离不开对变量的“察言观色”。今天，我们就来深入探讨在AnQiCMS模板中，如何优雅地进行最基本的条件判断，特别是判断变量是否存在和有值。

一、AnQiCMS模板中的条件判断基础

AnQiCMS的模板语法沿袭了Django模板引擎的风格，条件判断使用{% if ... %}标签对。它允许我们根据某个表达式的真假来决定是否渲染特定的内容块。一个完整的条件判断结构通常包括{% if %}、可选的{% elif %}（else if）和{% else %}，以及最终的{% endif %}来结束判断。

例如，一个最简单的判断可能是这样：

{% if archive.Id == 10 %}
    <p>这是文档ID为10的文档的特别内容。</p>
{% else %}
    <p>这不是文档ID为10的文档。</p>
{% endif %}

这样的结构为我们提供了控制页面元素显示与否的基础骨架。而要判断一个变量是否存在或有值，我们同样可以巧妙地运用这个{% if %}标签。

二、判断变量是否存在及有值：核心技巧与实践

在AnQiCMS模板中，判断变量是否存在或有值，主要依赖于模板引擎对“真值”（truthy）和“假值”（falsy）的理解。当一个变量被定义但其值为空字符串、0、nil（空值）、空集合（如空数组、空切片、空字典）时，它会被模板引擎视为“假值”；反之则为“真值”。

1. 直接判断变量名：最简洁的“是否存在”判断

判断一个变量是否存在或有值，最直接的方式就是将其放在{% if %}标签中。如果变量存在且被认为是“真值”，则条件成立。

假设我们正在展示一篇文档，并且希望只在文档设置了缩略图（Thumb）时才显示它：

{% if archive.Thumb %}
    <img src="{{ archive.Thumb }}" alt="{{ archive.Title }}" />
{% else %}
    <p>暂无缩略图。</p>
{% endif %}

在这里，archive.Thumb如果是一个有效的图片URL字符串，它就是“真值”，图片就会显示。如果archive.Thumb是空字符串或者nil，它就是“假值”，将显示“暂无缩略图”。这种方式简洁高效，是模板开发中常用的判断手法。

同样的逻辑也适用于判断数字、布尔值等：

{# 如果 archive.Views（浏览量）大于0，则显示 #}
{% if archive.Views %}
    <span>浏览量：{{ archive.Views }}</span>
{% endif %}

{# 如果 item.IsCurrent（是否当前）为true，则添加active类 #}
<li class="{% if item.IsCurrent %}active{% endif %}">
    <a href="{{ item.Link }}">{{ item.Title }}</a>
</li>

2. 判断集合（列表）是否为空：{% for ... empty %}的优雅运用

当我们需要判断一个集合（如archiveList或categoryList返回的列表）是否包含元素时，除了使用{% if collection_name %}，AnQiCMS还提供了更为优雅且语义化的{% for ... empty %}结构。

这个结构允许您在遍历集合时，如果集合为空，则执行{% empty %}块中的内容：

{% archiveList archives with type="list" categoryId="1" limit="10" %}
    {% for item in archives %}
        <li><a href="{{ item.Link }}">{{ item.Title }}</a></li>
    {% empty %}
        <li>该分类下没有任何文档。</li>
    {% endfor %}
{% endarchiveList %}

这段代码清晰地表达了“如果有文档就遍历显示，否则就提示没有内容”的逻辑，避免了额外的{% if %}判断，让代码更加紧凑易读。

3. 判断变量不存在（否定判断）：使用{% if not %}

有时，我们可能需要判断一个变量不存在或无值时才执行某些操作。这时，可以在变量前加上not关键字。

例如，在文章详情页，我们经常会显示“上一篇”和“下一篇”链接。如果当前文章没有上一篇或下一篇，我们通常会显示“没有了”或者不显示链接：

{% prevArchive prev %}
    <div>
        上一篇：
        {% if not prev %}
            <span>没有了</span>
        {% else %}
            <a href="{{ prev.Link }}">{{ prev.Title }}</a>
        {% endif %}
    </div>
{% endprevArchive %}

{% nextArchive next %}
    <div>
        下一篇：
        {% if not next %}
            <span>没有了</span>
        {% else %}
            <a href="{{ next.Link }}">{{ next.Title }}</a>
        {% endif %}
    </div>
{% endnextArchive %}

{% if not prev %}会判断prev变量是否为“假值”（即不存在或为空），从而决定显示提示信息还是实际的链接。

4. 使用default过滤器提供默认值：展示型判断

除了控制内容块的显示与否，有时我们仅仅希望在变量没有值时，能够显示一个预设的默认文本，而不是控制整个代码块的逻辑。这时，可以使用default过滤器。

default过滤器会在变量为“假值”时，返回您指定的默认值。请注意，这不会改变模板的渲染逻辑，只是提供一个备用显示内容。

<p>作者：{{ archive.Author|default:"佚名" }}</p>
<p>发布日期：{{ stampToDate(archive.CreatedTime, "2006-01-02")|default:"未知日期" }}</p>

在这个例子中，如果archive.Author没有值，页面将显示“佚名”；如果archive.CreatedTime无法被格式化（例如值为0或nil），则显示“未知日期”。这种方式特别适合于那些可选的、不影响页面核心布局的文本信息。

此外，还有一个default_if_none过滤器，它更严格，只在变量是Go语言中的nil（空指针）时才提供默认值，而不会像default那样对空字符串、0等也生效。在大多数Web模板场景中，default通常已足够使用。

三、结合实际场景的应用

掌握了这些基本的条件判断技巧，您就可以在AnQiCMS模板中游刃有余地控制内容的显示：

• **图片资源的按需加载