在使用 AnQiCMS 构建网站时，模板中经常需要处理一些表示“是”或“否”的状态值。例如，一个文章是否已发布，一个功能是否已启用，或者某个设置项是否为真。系统提供了一个非常实用的 yesno 过滤器，能够帮助我们优雅地将这些布尔值或三态逻辑（真、假、空）转换为友好的文本显示。

这个 yesno 过滤器最初设计时，默认会将 true 值显示为“yes”，false 值显示为“no”。而对于那些既不是真也不是假，或者说是一个空值（nil/empty）的情况，它则会显示为“maybe”。这种默认的英文显示方式在某些场景下可能不太符合我们的需求，特别是当网站主要面向中文用户时，我们更希望看到“是”、“否”、“未知”这样的表达。

幸运的是，AnQiCMS 的 yesno 过滤器提供了灵活的自定义功能，让我们能够根据实际需要，轻松调整这些显示文本。自定义的方法非常直观，只需在过滤器后面提供一个逗号分隔的字符串，其中包含我们希望显示的“真”、“假”和“未知”这三种状态的文本。

例如，如果我们希望将 true 显示为“是”，false 显示为“否”，而空值或未知状态显示为“未知”，我们可以这样来使用 yesno 过滤器：

{{ archive.IsPublished|yesno:"是,否,未知" }}

在这段代码中，archive.IsPublished 是我们想要判断的状态值。紧随其后的 |yesno 便是调用过滤器，而 :"是,否,未知" 则提供了自定义的显示文本。此时，如果 archive.IsPublished 为真，模板将输出“是”；如果为假，将输出“否”；如果 archive.IsPublished 是一个空值（例如，该字段未设置或为 null），则会输出“未知”。

值得注意的是，如果你只提供了两个自定义文本，例如 |yesno:"启用,禁用"，那么它们将分别对应 true 和 false 的显示文本。而对于空值或未知状态，过滤器会默认退回到显示“maybe”。例如：

{{ user.IsActive|yesno:"启用,禁用" }}

这里，如果 user.IsActive 为真，将显示“启用”；为假，显示“禁用”；而如果 user.IsActive 是空值，则会显示“maybe”。因此，为了确保所有状态都有明确的中文显示，建议始终提供三个自定义文本。

这种自定义功能在多语言网站或者需要特定业务术语的场景下尤其有用。比如，在一个电商网站中，我们可以将商品库存状态显示为“有货”、“无货”、“待补货”；在一个会员系统中，将会员状态显示为“正常”、“冻结”、“待审核”。通过调整 yesno 过滤器的显示文本，我们可以让网站内容更加贴合用户习惯，提升用户体验。

总而言之，yesno 过滤器是一个小巧却功能强大的工具，它帮助我们以更加灵活和用户友好的方式展示模板中的状态信息。通过简单的字符串参数，我们可以轻松实现“是”、“否”、“未知”等多种自定义显示，让AnQiCMS的模板内容更加本地化和个性化。

常见问题 (FAQ)

  1. 问：如果我只给 yesno 过滤器提供一个自定义文本，它会如何显示？ 答： 如果你只提供一个自定义文本，例如 {{ some_value|yesno:"已完成" }}，那么这个文本通常会被用于 true 的情况。而 false 和 nil/空值的情况，会分别退回到显示默认的 “no” 和 “maybe”。为了避免这种不一致，建议至少提供两个（对应 true 和 false）或三个（对应 true、false 和 nil）自定义文本。

  2. 问：能否在不同的模板区域或不同上下文中为 yesno 过滤器设置不同的显示文本？ 答： 完全可以。yesno 过滤器每次使用时都可以独立设置其显示文本。这意味着你可以在一个地方将其配置为“开启,关闭,未设置”，而在另一个地方则使用“已批准,已拒绝,待处理”，这取决于当前上下文的需要。这种灵活性使得AnQiCMS的模板可以高度适应各种内容显示需求。

  3. 问：yesno 过滤器除了处理布尔值外，还能处理哪些类型的变量？ 答： yesno 过滤器主要设计用于处理布尔值 (true/false) 以及能够被Go语言模板引擎评估为布尔值或“空”状态的变量。这意味着除了明确的布尔值外，像 nil、空字符串、零值数字（如 0）等也可能被识别为 false 或 nil/空。具体行为可能取决于变量的实际类型及其在Go模板中的评估规则，但其核心逻辑是将其解析为三种状态之一：真、假或未知/空。