在使用AnqiCMS构建网站的过程中，我们经常会遇到这样的情况：模板中需要显示某个变量的内容，但这个变量可能由于各种原因在某些情况下是空的，比如没有设置缩略图、某个列表没有内容，或者某个可选信息没有填写。如果不对这些空变量进行处理，页面可能会出现难看的空白区域、报错信息，或是排版错乱，这无疑会影响用户体验。
AnqiCMS强大的模板引擎提供了多种机制来优雅地处理这些可能为空的变量，确保即使在数据不完整的情况下，网站也能保持良好的显示效果和用户体验。下面我们将详细探讨几种实用的策略。
处理空数组或列表：{% for ... empty %} 的优雅之道
当您需要在模板中循环展示一个列表（例如文章列表、图片组图等），但又不确定这个列表是否总会有内容时，AnqiCMS模板引擎中的{% for ... empty %}结构是您的得力助手。它允许您在for循环体内正常处理有数据的情况，同时在empty块中定义当列表为空时需要显示的内容。
例如，在一个分类页面需要展示文章列表，但该分类下可能没有文章：
{# 假设 archives 是一个可能为空的文章列表 #}
<div>
{% archiveList archives with type="page" limit="10" %}
{% for item in archives %}
<div class="article-item">
<a href="{{item.Link}}">
<h5>{{item.Title}}</h5>
<div>{{item.Description}}</div>
</a>
</div>
{% empty %}
<div class="no-content-message">
抱歉，当前分类下暂无文章。
</div>
{% endfor %}
{% endarchiveList %}
</div>
在这个例子中，如果archives列表有内容，系统会正常渲染每一篇文章的标题和描述。但如果archives为空，{% empty %}块中的“抱歉，当前分类下暂无文章。”这段文字就会被显示出来，避免了页面空白。
处理空字符串或单个值：default 过滤器的妙用
对于单个变量（如字符串、数字或对象属性），如果它们可能为空或未定义，使用default过滤器是一种简洁高效的方法。这个过滤器会在变量值为空或未定义时，提供一个预设的默认值进行显示。
例如，您想显示网站的备案号，但后台可能未填写，或者某个文章的缩略图不存在：
{# 显示网站备案号，如果为空则显示“暂无备案信息” #}
<p><a href="https://beian.miit.gov.cn/" rel="nofollow" target="_blank">{% system with name="SiteIcp" %}{% else %}{{'暂无备案信息'}}</a> ©2021 AnQiCMS. All Rights Reserved</p>
更优的实现方式，是使用过滤器：
{{ variable|default:"默认值" }}
例如，当您需要显示文章的缩略图，但某些文章可能没有上传缩略图时：
<img src="{{ item.Thumb|default:'/static/images/default-thumb.jpg' }}" alt="{{ item.Title|default:'无标题文章' }}" />
这里，如果item.Thumb为空，图片会显示为/static/images/default-thumb.jpg这张默认图；如果item.Title为空，alt属性则会显示“无标题文章”。
值得一提的是，AnqiCMS模板引擎还提供了default_if_none过滤器。default过滤器会将空字符串、数字0、布尔值false以及nil（空指针）都视为空。而default_if_none则只针对nil值生效。在Go语言的模板环境中，这能更精确地处理数据为空指针而非空字符串的情况。通常情况下，default过滤器足够应对大多数场景。
灵活掌控显示逻辑：{% if ... %} 条件判断
除了上述直接设置默认值的方法，{% if ... %}条件判断标签提供了更细致的控制。您可以检查变量是否存在、是否非空，甚至进行更复杂的逻辑判断，从而决定是否显示某个元素或显示哪种备用内容。
例如，页面可能有一个规范链接（Canonical URL），但并非所有页面都需要设置，或者只有设置了才显示相应的<link>标签：
{%- tdk canonical with name="CanonicalUrl" %}
{%- if canonical %}
<link rel="canonical" href="{{canonical}}" />
{%- endif %}
在这里，{%- if canonical %}会检查canonical变量是否有值。如果canonical为空，整个<link>标签就不会被渲染到页面上。这种方式在处理一些不一定存在的SEO标签、可选的社交分享按钮等场景时非常有用。
再比如，您想显示文章的标签，但有些文章可能没有打标签：
{% tagList tags with itemId=item.Id limit="10" %}
{% if tags %} {# 检查 tags 列表是否非空 #}
<div class="article-tags">
标签：
{% for tag in tags %}
<a href="{{tag.Link}}">{{tag.Title}}</a>
{% endfor %}
</div>
{% endif %}
{% endtagList %}
综合运用，打造健壮模板
在实际的模板开发中，这些方法可以根据具体需求灵活组合。您可以先用{% if %}判断一个大的区块是否有内容，如果没有则整个区块不显示；在有内容的区块内部，对于可能为空的单个变量，再使用default过滤器设置默认值；对于可能为空的列表，则使用{% for ... empty %}结构。
通过这些策略，您的AnqiCMS网站模板将变得更加健壮，无论是数据完整还是不完整，都能够以优雅、友好的方式呈现给用户，大幅提升网站的可用性和专业度。
常见问题解答 (FAQ)
1. default 过滤器和 default_if_none 过滤器在AnqiCMS模板中有什么区别？
default过滤器会检查变量是否为空值（包括空字符串、数字0、布尔值false以及nil/null），如果为空则使用您提供的默认值。而default_if_none则更为严格，它只会在变量的值为nil（空指针）时才使用默认值，对于空字符串、数字0等有“值”但“空”的情况，它不会触发默认值。在AnqiCMS的Go语言后端环境中，理解这一点有助于更精确地处理数据类型。
2. 为什么我的 {% for ... empty %} 代码没有生效，列表为空时仍然显示空白？
这通常有几个原因。首先，请确保您的for循环变量确实是一个数组、切片（slice）或可迭代的对象。如果它是一个单个值，empty块将不会被触发。其次，检查您传递给for循环的变量是否真的为空。有时候，变量可能包含一个空对象而不是一个空的数组，或者它本身就是nil，此时for循环可能直接跳过而不进入empty块。在这些情况下，您可能需要在{% for %}标签外部先用{% if %}对变量进行更全面的判断。
3. 如何为后台自定义的模型字段设置默认显示值？
AnqiCMS在自定义内容模型时，允许您为字段设置默认值（在“内容模型使用帮助”文档中提到）。如果后台已经为某个自定义字段设置了默认值，那么在模板中直接调用该字段即可，系统会自动使用后台设置的默认值。如果该字段没有设置后台默认值，或者您希望在模板层面提供一个不同的备用默认值，那么可以使用default过滤器，例如 {{ item.custom_field|default:'这里是自定义字段的默认值' }}。