AnQiCMS 如何在模板中判断变量是否为空并显示默认内容？

在网站内容运营中，数据的完整性和展示的优雅性至关重要。我们经常会遇到这样的情况：某些字段的数据可能因为各种原因而缺失，比如一篇文章可能没有配图，一个产品可能没有详细描述，或者一个自定义字段可能没有填写。如果模板代码没有做相应的空值判断，轻则导致页面出现空白，影响美观，重则可能引发模板渲染错误，影响用户体验。

AnQiCMS 凭借其基于 Go 语言的高效架构和类似 Django 模板引擎的灵活设计，为我们提供了多种强大而直观的方式来判断模板中的变量是否为空，并据此显示默认内容，让网站在数据不完整时依然能够保持良好的用户体验。接下来，就让我们一起探索这些实用的技巧。

最直观且功能强大：{% if ... %} 逻辑判断标签

在 AnQiCMS 的模板中，if 标签是我们进行条件判断的核心工具。它能够判断一个变量的“真值”或“假值”。 当一个变量被视为“假值”时（例如空字符串 ""、数字 0、布尔值 false，以及 Go 语言中的 nil，相当于其他语言的 null 或 None），if 语句就会执行其 else 块中的内容。

基本用法：

假设你有一个文章对象 archive，其中可能包含 Title（标题）和 Description（描述）等字段。你可以这样判断 Title 是否为空：

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

如果 archive.Title 不为空，页面会显示实际标题；否则，会显示“暂无标题”。同样，您也可以利用 if not 来判断变量为空的情况：

{% if not archive.Description %}
    <p>该文章暂无详细描述。</p>
{% else %}
    <p>{{ archive.Description }}</p>
{% endif %}

这种方法适用于需要显示整个 HTML 块或执行更复杂逻辑的场景。

快捷方式：default 过滤器

当您只需要简单地在输出时提供一个默认值，而不需要复杂的逻辑判断结构时，default 过滤器是您的**选择。它简洁高效，能让代码更加易读。

default 过滤器会在变量被评估为“假值”时（包括空字符串 ""、数字 0、布尔值 false 以及 nil），显示您提供的默认内容。

使用示例：

<p>作者：{{ archive.Author|default:"佚名" }}</p>
<img src="{{ archive.Logo|default:'/static/images/default_logo.png' }}" alt="{{ archive.Title|default:'文章图片' }}" />
<p>价格：{{ product.Price|default:0 }} 元</p>

在上面的例子中：

  • 如果 archive.Author 为空，将显示“佚名”。
  • 如果 archive.Logo 为空（或无效），将显示 /static/images/default_logo.png 作为默认图片。
  • 如果 product.Price 为空或 0，将显示 0 元。

default 过滤器非常适合内联输出，能够有效避免页面中出现空白或破损链接。

针对列表：{% for ... %} 结合 {% empty %}

处理列表数据时，尤其是需要判断列表是否为空并显示提示信息时，for 循环的 empty 块非常实用。它提供了一种优雅的方式来处理列表无内容的情况，避免了冗余的 if 判断。

使用示例：

假设您要显示相关文档列表，但有时可能没有找到相关内容：

{% archiveList relatedArchives with type="related" limit="5" %}
    {% for item in relatedArchives %}
        <div class="related-item">
            <a href="{{ item.Link }}">{{ item.Title }}</a>
        </div>
    {% empty %}
        <div class="no-related-content">暂无相关文档。</div>
    {% endfor %}
{% endarchiveList %}

如果 relatedArchives 列表为空或者不存在，empty 块中的内容就会被渲染出来，提示用户没有相关内容，而不是留下一个空白的区域。

更精准的判断：default_if_none 过滤器

在某些特定场景下，您可能需要区分变量是完全不存在（nil）还是仅仅是空值（如空字符串 ""、数字 0）。这时 default_if_none 过滤器就派上用场了。

default_if_none 过滤器只会在变量的值为 nil 时显示默认内容。这意味着它不会对空字符串 "" 或数字 0 生效。

使用示例：

假设有一个自定义字段 product.Specification，它可能是 nil（未设置），也可能是 ""（设置了但内容为空）。

<p>产品规格（default）：{{ product.Specification|default:"未填写" }}</p>
<p>产品规格（default_if_none）：{{ product.Specification|default_if_none:"未设置" }}</p>
  • 如果 product.Specification 是 nil：
    • 第一行将显示“未填写”。
    • 第二行将显示“未设置”。
  • 如果 product.Specification 是 ""（空字符串）：
    • 第一行将显示“未填写”。
    • 第二行将显示一个空字符串（即不显示任何内容）。

这个过滤器在需要严格区分“未赋值”和“赋值但为空”的场景中非常有用。

结合实际场景的**实践

  • 图片和链接： 对于图片 src 属性和链接 href 属性，使用 default 过滤器提供一个备用图片或链接，防止页面出现“断链”图标或无法访问的链接。
  • 富文本内容： 对于文章详情、产品描述等富文本内容，通常内容为空时直接隐藏该区域或显示“暂无内容”提示会更好，这时 {% if ... %} 结合 safe 过滤器（用于安全地渲染 HTML 内容）会是更好的选择： 
    
{% if archive.Content %}
    <div class="article-content">{{ archive.Content|safe }}</div>
{% else %}
    <div class="article-content">暂无详细内容。</div>
{% endif %}
  • 自定义字段： AnQiCMS 强大的内容模型允许我们创建各种自定义字段。在模板中调用这些字段时，同样需要做好空值判断。 
    
{% archiveDetail author with name="author" %}
{% if author %}
    <p>作者：{{ author }}</p>
{% else %}
    <p>作者信息待补充。</p>
{% endif %}

通过灵活运用这些判断变量是否为空的方法，您可以编写出更加健壮、用户体验更佳的