在安企CMS的模板开发过程中，我们经常需要根据数据的具体内容来决定页面如何展示，或者判断某个特定元素是否存在于我们传入的数据中。当处理的数据类型是复杂的数组或键值对（Map）时，高效而准确地进行这类判断尤为重要。这里，contain 过滤器就成为了一个非常实用的工具。

contain 过滤器：灵活判断数据是否包含指定内容

contain 过滤器在安企CMS的模板引擎中扮演着一个核心角色，它允许我们在模板中检查一个数据集合（如字符串、数组、Map或结构体）中是否包含特定的值或键。这个过滤器的强大之处在于其适应性，能够处理不同类型的数据，并返回一个清晰的布尔值（True 或 False），极大地简化了条件判断的逻辑。

当您需要在模板中判断以下情况时，contain 过滤器都能提供直接的答案：

  1. 字符串中是否包含某个子字符串： 例如，检查一篇文章的标题中是否含有某个关键词。
  2. 数组（或Go语言中的slice）中是否包含某个元素： 例如，一个文档可能关联了多个标签，您需要判断其中是否存在某个具体的标签。
  3. 键值对（Map）或结构体（struct）中是否包含某个键名： 例如，您有一个配置Map，需要判断某个配置项是否存在。

无论您的数据是哪种形式，contain 过滤器的使用方式都保持一致，其基本语法为：{{ obj|contain:"关键词" }}。其中 obj 代表您要检查的数据变量，而 "关键词" 则是您希望查找的内容。

实际应用场景示例

让我们通过几个具体的例子来了解 contain 过滤器如何在安企CMS模板中发挥作用。

示例一：检查字符串中是否包含特定文字

假设您希望在页面上，如果某个描述性文字中提到了“优惠”，就显示一个特殊的提示。

{% set description = "本店所有商品限时优惠，欢迎选购！" %}
{% if description|contain:"优惠" %}
    <p class="promo-text">🎉 机会难得，立即抢购！</p>
{% else %}
    <p>欢迎浏览本店商品。</p>
{% endif %}

这段代码会先将字符串赋值给 description 变量，然后使用 contain 过滤器检查其中是否包含“优惠”二字。由于示例中包含，页面将显示“🎉 机会难得，立即抢购！”。

示例二：判断数组中是否存在某个元素

假设您有一个产品列表，每个产品都有一个 tags 数组（例如：["新品", "热销", "推荐"]）。现在，您想筛选出所有带有“热销”标签的产品。

{% set product_tags = ["新品", "热销", "限量"] %}
{% if product_tags|contain:"热销" %}
    <span class="badge hot-sale">热销商品</span>
{% else %}
    <span class="badge normal">普通商品</span>
{% endif %}

在这里，product_tags 被视为一个数组，contain 过滤器会检查其中是否有“热销”这个字符串元素。如果存在，对应的产品就会被标记为“热销商品”。

示例三：验证Map或结构体中是否存在指定键名

在处理动态数据时，有时不确定传入的Map或结构体中是否存在某个键。例如，您有一个页面配置 page_config，需要判断它是否定义了 banner 键。

{% set page_config = {"title": "关于我们", "content": "公司简介", "sidebar": true} %}
{% if page_config|contain:"banner" %}
    <div class="page-banner">
        <!-- 显示页面横幅内容 -->
    </div>
{% else %}
    <div class="no-banner-placeholder">
        <!-- 页面无横幅 -->
    </div>
{% endif %}

在这个例子中，contain 过滤器用于检查 page_config Map中是否存在名为 banner 的键。由于 page_config 中没有这个键，所以条件不成立，页面会显示“页面无横幅”。值得注意的是，对于Map或结构体，contain 过滤器是检查其键名而非键值。

总结

contain 过滤器是安企CMS模板引擎中一个简单却功能强大的工具，它使得在模板中进行条件判断变得更加直观和高效。无论是对字符串进行模糊匹配，还是对数组元素或Map键名进行精确查找，它都能提供可靠的布尔结果，帮助您构建更加动态和智能的网站内容。掌握这一过滤器，无疑能让您的安企CMS模板开发工作如虎添翼。

常见问题 (FAQ)

  1. 如何判断数组或字符串中“不”包含某个关键词？ 您可以使用 not 关键字与 contain 过滤器结合来判断否定情况。例如：{% if not my_string|contain:"关键词" %} 或者 {% if not my_array|contain:"元素" %}。

  2. contain 过滤器在检查字符串时是否区分大小写？ 是的，默认情况下 contain 过滤器是区分大小写的。例如，"AnQiCMS"|contain:"cms" 会返回 False，因为它无法找到完全匹配小写“cms”的子字符串。如果您需要进行不区分大小写的检查，可能需要在业务逻辑层对字符串进行预处理（如全部转换为大写或小写）再传入模板，或考虑自定义更复杂的过滤器。

  3. 我能否使用 contain 过滤器检查嵌套数组或 Map 中的值？ contain 过滤器直接检查的是当前层级的数据（字符串的子串、数组的元素、Map的键名）。如果您需要检查嵌套结构中的值，通常需要通过 for 循环或其他模板逻辑先遍历到对应的嵌套层级，然后再在该层级上使用 contain 过滤器进行检查。例如，要检查一个包含多个用户Map的数组中是否存在某个用户的名字，您需要遍历这个数组，并在每个用户Map中检查 name 键的值。