在 AnQiCMS 模板开发中，我们经常会遇到需要判断某个变量是否为真、为假，或者干脆就不存在、为空值的情况。为了简洁高效地处理这些场景，AnQiCMS 提供了一个非常实用的内置过滤器——yesno。它能够优雅地识别变量的三种核心状态，并根据这些状态输出预设或自定义的文本，极大地简化了模板中的条件逻辑。

yesno 过滤器的工作原理：三态判断

yesno 过滤器的核心在于其“或与非”的三种状态判断机制，这使其在处理变量的各种存在形式时游刃有余。具体来说，它会依据以下规则来判断变量状态：

  1. 变量为真（true）时： 当变量的值被评估为布尔类型的 true 时，yesno 过滤器会输出“yes”。这通常适用于明确的布尔字段，或者被 AnQiCMS 模板引擎隐式转换为真的非空字符串、非零数字等。

  2. 变量为假（false）时： 反之，如果变量的值被评估为布尔类型的 false 时，过滤器会输出“no”。这包括明确的布尔 false、数字 0、空字符串 "" 等。

  3. 变量为空值或未定义（nil）时： 这是 yesno 过滤器特别有用的地方。当变量是一个空值（在 Go 语言中常表示为 nil）、未在模板上下文中定义，或者是一个空数组、空切片、空字典（map）时，yesno 过滤器会将其判断为第三种状态，默认输出“maybe”。这种判断能力使得我们能够轻松区分“假”和“不存在或为空”，这在很多业务场景中都非常关键。

基本使用方法

yesno 过滤器的使用方式非常直观，只需将其添加到变量后面，并用管道符 | 连接即可。

例如，如果我们有一个名为 archive.Status 的变量，它可能表示文章的发布状态：

<p>文章状态：{{ archive.Status | yesno }}</p>

根据 archive.Status 的实际值，这里可能会显示：

  • 如果 archive.Status 为 true，输出 文章状态：yes
  • 如果 archive.Status 为 false，输出 文章状态：no
  • 如果 archive.Status 为 nil 或未定义，输出 文章状态：maybe

自定义输出文本

默认的“yes”、“no”、“maybe”在某些场景下可能不够直观或不符合页面风格。yesno 过滤器允许我们自定义这三种状态对应的输出文本。您只需在过滤器后面提供三个以逗号 , 分隔的字符串，分别对应“真”、“假”和“空值或未定义”时的输出。

<p>文章发布状态：{{ archive.Status | yesno:"已发布,草稿,待审核" }}</p>

在这个例子中：

  • 如果 archive.Status 为 true，输出 文章发布状态：已发布
  • 如果 archive.Status 为 false，输出 文章发布状态：草稿
  • 如果 archive.Status 为 nil 或未定义，输出 文章发布状态：待审核

需要注意的是，如果你提供了自定义文本，必须按照“真值文本,假值文本,空值文本”的顺序提供三个值。如果只提供两个，那么当变量为空值时，仍然会输出默认的“maybe”。

实际应用场景

yesno 过滤器在 AnQiCMS 模板中可以应用于多种场景，尤其是在需要简洁地展示变量状态时：

  • 检查内容是否推荐或置顶： 假设文章模型中有一个自定义布尔字段 is_featured。

    <p>是否推荐：{{ archive.is_featured | yesno:"是,否,未设置" }}</p>

  • 判断网站某个功能是否启用： 在系统设置中，我们可能定义了一个参数 SiteClose 来控制网站是否关闭。

    <p>网站状态：{{ system.SiteClose | yesno:"已关闭,正常运行" }}</p>

    这里只提供了两个参数，当 system.SiteClose 为 true（已关闭）时显示“已关闭”，为 false（未关闭）时显示“正常运行”。如果 system.SiteClose 未设置或为空，将显示默认的“maybe”。

  • 处理可能为空的用户信息： 在显示用户信息时，如果某个字段（例如用户的邮箱地址）可能为空或未定义。

    <p>用户邮箱：{{ user.Email | yesno:user.Email+",暂无邮箱,未注册" }}</p>

    在这个例子中，如果 user.Email 有值，它会直接显示邮箱地址；如果 user.Email 为 false（例如空字符串），则显示“暂无邮箱”；如果 user.Email 为 nil 或未定义，则显示“未注册”。这种灵活的组合用法可以帮助我们针对性地展示信息。

总之，yesno 过滤器是 AnQiCMS 模板中一个简单却强大的工具，它帮助我们以优雅的方式处理变量的多种状态，避免了复杂的 if-else 嵌套，让模板代码更加整洁易读，提升了开发效率和模板的可维护性。

常见问题 (FAQ)

1. yesno 过滤器能处理哪些类型的变量？

yesno 过滤器主要用于处理布尔值 (true/false)。但它也很智能，对于非布尔类型，它会尝试将其转换为布尔上下文进行判断（例如，非空字符串、非零数字通常被视为 true；空字符串、数字 0 则被视为 false）。最重要的是，它能识别 nil（空值）或未定义的变量，这是其区别于简单布尔判断的关键。

2. 如果变量既不是 true 也不是 false，而是完全不存在（例如拼写错误），yesno 会如何表现？

当变量在模板上下文中完全不存在（例如变量名拼写错误，或者该数据模型中根本没有这个字段）时，yesno 过滤器会将其判断为第三种状态——空值或未定义。此时，它会输出默认的“maybe”，或者你自定义的第三个文本值。这对于处理可能缺失或意外不存在的数据非常有用，可以避免模板渲染错误。

3. yesno 过滤器和 if 逻辑判断标签有什么区别？什么时候应该使用哪个？

if 逻辑判断标签 ({% if ... %}) 主要用于执行更复杂的条件逻辑分支，例如根据一个或多个条件来显示整个内容块、控制循环或改变模板结构。而 yesno 过滤器则专注于将变量的三种状态直接、简洁地转换为一个字符串输出。当你只需要根据变量的真假或空值状态显示一段文本、一个图标或一个简短的描述时，yesno 过滤器是更简洁高效的选择。当你需要根据条件渲染不同的大段 HTML 代码或执行更复杂的逻辑时，if 标签则更合适。