AnQiCMS模板中如何为可能为空的变量设置默认显示值？

在使用AnQiCMS构建网站时，我们经常会遇到这样的情况：某些内容字段并非每次都有值，例如文章可能没有缩略图，产品可能没有详细描述，或者某些联系方式可能尚未填写。如果直接在模板中调用这些可能为空的变量，页面上就可能出现难看的空白，甚至是程序错误，这会极大地影响用户体验和网站的专业性。

幸运的是，AnQiCMS的模板系统基于类似Django和Blade的语法，提供了强大而灵活的机制来处理这些情况，允许我们为可能为空的变量设置优雅的默认显示值。

1. 利用 default 过滤器设置基础默认值

最直接、最常用的方法就是利用AnQiCMS模板内置的default过滤器。它的作用非常简单：当变量不存在或其值为空时，它会自动显示您预设的默认值。这里的“空”通常包括空字符串、布尔值false、数字0以及Go语言中的nil。

使用方法非常直观，只需在变量名后通过管道符|连接default过滤器，并用双引号指定您的默认文本。

例如，如果您的文章简介archive.Description可能为空，而您希望在这种情况下显示“暂无简介”，您可以这样写：

<p>{{ archive.Description|default:"暂无简介" }}</p>

同样地，对于一些不一定存在的联系方式，比如WhatsApp，如果后台没有填写，我们可以给它一个默认的提示：

<p>WhatsApp: {{ contact.WhatsApp|default:"未设置" }}</p>

这样，即使archive.Description或contact.WhatsApp在数据库中是空值，页面上也不会出现空白，而是友好地显示“暂无简介”或“未设置”，确保了内容的完整性。

2. 精确处理空值：default_if_none 过滤器

在某些特定场景下，您可能需要更精确地判断，只对变量值为nil（表示变量根本不存在或未赋值，而非仅仅是空字符串）的情况设置默认值，而对于空字符串则保留原样。AnQiCMS为此提供了default_if_none过滤器。

这个过滤器与default的主要区别在于它只针对nil值生效。如果变量的值是空字符串（""），default_if_none会将其视为一个有效值并显示出来，而default则会将其视为“空”并显示默认值。

使用方式与default过滤器相同：

<p>文章作者: {{ archive.Author|default_if_none:"匿名读者" }}</p>

假设archive.Author字段：

• 如果为nil：显示“匿名读者”。
• 如果为""（空字符串）：显示空字符串（即不显示任何内容）。
• 如果为"张三"：显示“张三”。

了解这两个过滤器的细微差别，可以帮助您更精准地控制模板的渲染逻辑。

3. 利用条件判断 {% if %} 标签渲染不同结构

除了直接设置默认文本，有时您可能需要根据变量是否存在，来显示完全不同的内容结构，甚至是不显示某些区块。AnQiCMS的模板支持类似于Django语法的{% if 条件 %}标签，这让我们可以灵活地进行条件渲染。

当变量有值时，显示一段HTML；当变量为空时，显示另一段不同的HTML结构，或者一个占位符图片。这在处理图片、广告位、可选内容模块时尤其有用。

例如，为文章设置一个默认缩略图： 我们首先通过archiveDetail标签获取文章的Logo图片，然后使用{% if %}进行判断。

{% archiveDetail articleLogo with name="Logo" %}
{% if articleLogo %}
    <img src="{{ articleLogo }}" alt="文章图片">
{% else %}
    <img src="/public/static/images/default-thumbnail.jpg" alt="默认缩略图">
{% endif %}

这段代码的逻辑是：如果articleLogo变量有值（即文章有配图），就显示这张图片；否则，显示一张预设的默认缩略图。这样可以避免因图片缺失而导致的页面布局错乱或图片占位符破损。

再比如，某些联系信息只在有值时才显示对应的链接：

{% contact email with name="Email" %}
{% if email %}
    <p>联系邮箱：<a href="mailto:{{ email }}">{{ email }}</a></p>
{% endif %}

如果email变量为空，则整个p标签都不会渲染出来，保持页面简洁。

4. 进阶技巧：预设变量与灵活复用（{% set %} 或 {% with %}）

在某些场景下，您可能希望在模板文件的顶部或某个逻辑区块内，先为变量设置一个初始的默认值，然后在多个地方引用这个变量。AnQiCMS提供了{% set %}和{% with %}标签来实现这一点。

• {% set %} 定义局部变量： {% set %}标签用于在当前模板文件中定义一个新变量，这个变量可以在定义后的任何地方使用。

  {% set articleTitle = archive.Title|default:"无标题文章" %}
  <h1>{{ articleTitle }}</h1>
  <p>页面标题：{{ articleTitle }}</p>
  

  这里，articleTitle变量被赋予了archive.Title的值，如果archive.Title为空，则使用“无标题文章”作为默认值。之后，我们就可以多次复用articleTitle。

• {% with %} 定义作用域变量： {% with %}标签则用于在指定区块内定义一个或多个变量，这些变量只在该{% with %}和{% endwith %}之间有效。它也可以在{% include %}标签中传递默认值。

  {% with defaultDesc="此内容暂无详细描述。请等待后续更新。" %}
      <p>{{ archive.Description|default:defaultDesc }}</p>
  {% endwith %}
  

  在这个例子中，defaultDesc只在{% with %}区块内有效，用于为archive.Description设置默认值。

总结

在AnQiCMS模板中为可能为空的变量设置默认显示值，是构建健壮且用户友好网站的关键一环。

• 对于简单的文本内容缺失，直接使用default过滤器是最便捷的方式。
• 需要严格区分nil和空字符串时，default_if_none过滤器提供了更精细的控制。
• 当需要根据变量是否存在来显示不同的HTML结构时，{% if %}条件判断是不可或缺的。
• 而{% set %}或{% with %}标签则能帮助您更有效地管理和复用默认变量，使模板代码更加清晰。

掌握这些技巧，您将能够创建出更加稳定、优雅的AnQiCMS网站模板