`default` 和 `default_if_none` 过滤器如何为可能为空的变量设置默认显示值？

在网站内容管理中，我们经常会遇到变量值可能为空的情况。这些空值如果直接展示在前端页面上，可能会导致内容显示不完整、页面布局错乱，甚至给用户带来不佳的体验。安企CMS（AnQiCMS）作为一个功能强大的内容管理系统，其采用的Django模板引擎语法为我们提供了灵活的方式来处理这类问题。其中，default 和 default_if_none 这两个过滤器就是解决变量为空时显示默认值的利器。

default 过滤器：为“空”值提供一个通用备选

想象一下，你正在构建一个文章详情页，其中有一个字段用于显示文章的作者。如果某篇文章没有指定作者，或者作者字段恰好是空字符串，你肯定不希望页面上显示一片空白或者一个难看的(null)。这时，default 过滤器就派上用场了。

default 过滤器就像给变量买了一份“万能险”。当它发现变量的值是“空”的时候，就会自动显示你预设的默认值。这里的“空”是一个相对宽泛的概念，它包括了：

• 空字符串（""）
• 数字 0（0）
• 布尔值 false（false）
• 以及表示没有值的 nil (空值)

它的使用方式非常直观，只需要在变量后面加上 |default:"默认值" 即可。

示例：

假设我们有一个变量 article.Author，用于显示文章作者。

• 如果我们想在 article.Author 为空时显示“匿名作者”：

  {{ article.Author|default:"匿名作者" }}
  

  如果 article.Author 是“张三”，会显示“张三”；如果是空字符串 ""，会显示“匿名作者”；如果是 nil，也会显示“匿名作者”。

• 再比如，显示一个用户的积分 user.Score，如果用户没有积分或者积分是0，我们希望显示“暂无积分”：

  {{ user.Score|default:"暂无积分" }}
  

  如果 user.Score 是 100，显示 100；如果是 0，显示“暂无积分”。

通过 default 过滤器，我们可以轻松地让页面内容在变量缺失或为空时，依然保持良好的可读性和用户体验。

default_if_none 过滤器：针对“真”空值的精准替补

然而，在某些场景下，我们可能需要更精确的控制。例如，一个图片的URL字段 article.ImageUrl，如果它明确地被设置为 nil（表示没有这张图），我们希望显示一个占位图。但如果它是一个空字符串 ""（可能意味着图片地址是空的，但字段本身存在），我们可能希望保持原样，或者采用不同的逻辑。这时，default_if_none 过滤器则显得更为“精准”。

default_if_none 过滤器专注于判断变量是否是真正意义上的空值（nil，在许多编程语言中也称为 null）。它不会将空字符串 ""、数字 0 或布尔值 false 视为需要替换的“空”值。只有当变量的值是 nil 时，它才会应用你设定的默认值。

示例：

• 如果有一个变量 optionalImage 可能为 nil（无图片），我们想为它设置一个占位图：

  
  <img src="{{ optionalImage|default_if_none:"/static/images/placeholder.jpg" }}" alt="图片" />
  

  如果 optionalImage 的值是 nil，图像的 src 将是 /static/images/placeholder.jpg。 但如果 optionalImage 的值是空字符串 ""，那么 src 属性依然会是 ""，这与 default 过滤器的行为是不同的。

如何选择：default 还是 default_if_none？

选择使用哪个过滤器，取决于你对“空”的定义以及你的内容展示需求：

• 使用 default 过滤器： 当你希望所有“看起来”为空的值（包括 nil、空字符串、数字 0、布尔值 false）都被一个通用默认值替代时，default 是你的首选。它更适合大多数通用场景，能有效防止页面上出现空白或不友好的信息。

• 使用 default_if_none 过滤器： 如果你对空字符串、数字 0 或布尔值 false 有明确的展示需求，只希望在变量明确表示“没有值”(nil) 时才应用默认值，那么 default_if_none 将提供更精细的控制。这在你需要区分“没有设置”和“设置为空”这两种状态时特别有用。

在安企CMS的模板开发中，这两个看似相似的过滤器，实则提供了不同粒度的控制。理解它们的细微差别，能帮助我们编写出更健壮、更符合业务逻辑的前端模板，确保网站内容的展示始终如一，优雅且可靠。

常见问题 (FAQ)

Q1: default 和 default_if_none 过滤器最主要的区别是什么？ A1: 最主要的区别在于它们对“空”的定义。default 过滤器会将 nil、空字符串 ("")、数字 0 和布尔值 false 都视为需要替换的“空”值。而 default_if_none 过滤器则只会在变量的值是 nil (表示没有值) 时才进行替换，它会保留空字符串、数字 0 和布尔值 false 的原有显示。

Q2: 我可以在非字符串类型（如数字、布尔值）的变量上使用这些过滤器吗？ A2: 是的，当然可以。这两个过滤器不仅限于字符串变量。例如，如果一个数字变量 {{ price }} 可能为 nil 或 0，你可以使用 {{ price|default:9.99 }} 来确保总是显示一个价格。同样，布尔值 {{ is_active }} 如果是 nil 或 false，你也可以用 {{ is_active|default:"否" }} 来显示一个默认的文本。

Q3: 如果我希望设置的默认值本身也是一个变量，我该怎么写？ A3: 如果你的默认值是一个变量，你可以直接在过滤器参数中使用该变量。例如，假设你有一个变量 default_author_name 存储了默认作者的名字，你可以这样使用：

{{ article.Author|default:default_author_name }}

或者对于 default_if_none：

{{ optional_value|default_if_none:fallback_value_variable }}