`contain`过滤器在安企CMS模板中，如何判断字符串或数组是否包含某个关键词？

在安企CMS的模板开发中，我们经常需要根据数据的不同特性来动态调整页面的展示方式。其中，判断字符串或数组中是否包含某个关键词或元素，是一个非常基础但又极其常用的需求。此时，contain 过滤器便成为了我们手中的一把利器，它能帮助我们轻松实现这一目标。

contain 过滤器主要用于检查一个变量（无论是字符串、数组，还是键值对和结构体）中是否存在某个特定的内容。它的结果会是一个布尔值：如果包含，则返回 True；如果不包含，则返回 False。这使得我们能够在模板中编写更智能、更灵活的条件逻辑。

让我们通过具体示例来了解 contain 过滤器在不同场景下的应用。

判断字符串中是否包含关键词

当你的变量是一段文本时，contain 过滤器可以快速检查这段文本是否包含某个子字符串。这在许多场景下都非常有用，例如判断文章标题、内容摘要是否提及某个特定词汇。

示例：

{% set articleTitle = "安企CMS：企业建站好帮手，效率提升秘籍" %}

{% if articleTitle|contain:"CMS" %}
    <p>该文章标题中包含了 "CMS"，是关于内容管理系统的重要文章。</p>
{% else %}
    <p>该文章标题中不包含 "CMS"。</p>
{% endif %}

在上述例子中，articleTitle 变量中确实包含 “CMS”，因此条件成立，页面将显示第一段文字。

判断数组（切片）中是否存在元素

如果你的变量是一个数组（在Go语言模板中常表现为切片），contain 过滤器可以判断这个数组中是否存在某个完全匹配的元素。这适用于检查文章的标签列表中是否包含某个特定标签，或者多选字段的值是否包含某个选项。

示例：

假设 item.Tags 是一个包含多个标签的数组，例如 ["网站运营", "SEO优化", "内容营销"]。

{% set itemTags = ["网站运营", "SEO优化", "内容营销"] %}

{% if itemTags|contain:"SEO优化" %}
    <p>此文章属于 "SEO优化" 类别，内容对搜索引擎优化有帮助。</p>
{% else %}
    <p>此文章不属于 "SEO优化" 类别。</p>
{% endif %}

这里，因为 itemTags 数组中包含 “SEO优化” 这个元素，所以条件成立，页面会显示第一段文字。

判断键值对（map）或结构体（struct）中是否存在键名

当你的变量是一个键值对（如系统设置参数、自定义字段）或结构体时，contain 过滤器可以用来判断是否存在某个特定的键名（字段名）。这对于检查自定义字段是否存在，避免因字段缺失而导致模板渲染报错，或者根据不同字段的可用性来动态展示内容非常有用。

示例：

假设 product 是一个结构体或键值对，其中可能包含自定义的字段。

{% set product = {name:"智能手机", price:2999, color:"黑色"} %}

{% if product|contain:"color" %}
    <p>此产品有颜色选项：{{ product.color }}</p>
{% else %}
    <p>此产品没有颜色选项。</p>
{% endif %}

在这个例子中，product 包含了 “color” 这个键名，因此页面将显示带有颜色信息的段落。

结合 set 和 if 标签，实现更复杂的逻辑

contain 过滤器通常与 {% set %} 标签配合使用，将判断结果赋值给一个临时变量，然后再通过 {% if %} 标签进行条件判断，从而实现更复杂和清晰的模板逻辑。

{% set pageContent = "欢迎来到安企CMS的官方网站，这里提供高效、易用的内容管理解决方案。" %}
{% set isOfficialSite = pageContent|contain:"官方网站" %}

{% if isOfficialSite %}
    <div class="official-badge">
        <img src="/static/images/official.png" alt="官方认证">
        <p>此页面为官方内容，请放心浏览。</p>
    </div>
{% else %}
    <p>此页面可能为用户分享内容，信息仅供参考。</p>
{% endif %}

这样的写法不仅让逻辑更易读，也方便在后续模板中复用 isOfficialSite 这个判断结果。

实际应用场景总结

  • 内容动态高亮： 如果文章内容包含特定关键词，可以给关键词添加高亮样式。
  • 个性化推荐： 根据用户浏览历史的标签，判断推荐内容是否包含用户感兴趣的标签。
  • 导航菜单激活状态： 判断当前URL是否包含某个菜单链接，自动为菜单项添加 active 类。
  • 字段存在性检查： 在显示自定义字段内容前，先用 contain 检查该字段是否存在，避免因字段为空而显示不必要的内容。

几点重要的注意事项

  • 区分大小写： contain 过滤器在进行匹配时是区分大小写的。例如，"Apple"|contain:"apple" 将返回 False。如果需要不区分大小写的匹配，可能需要在判断前将字符串统一转换为大写或小写。
  • 数组元素完全匹配： 对于数组类型，contain 要求元素是完全匹配的，不会进行模糊匹配。
  • 键名/字段名匹配： 对于键值对或结构体，它检查的是键名或字段名，而不是键值。

contain 过滤器是安企CMS模板中一个强大且灵活的工具。熟练掌握它的用法，可以帮助我们编写出更具动态性、适应性强且代码简洁的模板，从而显著提升网站内容的管理效率和用户体验。

常见问题 (FAQ)

  1. contain 过滤器是否区分大小写？ 是的，contain 过滤器在进行匹配时是区分大小写的。例如，{{"AnQiCMS"|contain:"anqicms"}} 将返回 False。如果您需要不区分大小写的匹配，可以考虑在进行 contain 判断之前，先将字符串转换为统一大小写（例如，全部转换为小写）再进行比较。

  2. 除了 contain，安企CMS模板还有哪些类似功能的过滤器可以用来检查内容？ 安企CMS模板还提供了 count 过滤器和 index 过滤器。count 用于计算关键词或元素在字符串或数组中出现的次数，而 index 则返回关键词或元素首次出现的位置（如果未找到则返回-1）。它们都返回数字，与 contain 返回布尔值不同，您可以根据具体需求选择使用。

  3. contain 过滤器能用来检查自定义字段的“值”是否包含某个关键词吗？ contain 过滤器不能直接用于检查自定义字段的“值”是否包含特定关键词，除非该自定义字段的值本身就是字符串。它主要用于：

    1. 检查字符串本身是否包含子字符串。
    2. 检查数组中是否存在某个元素。
    3. 检查键值对或结构体中是否存在某个“键名”或“字段名”。 如果您想检查自定义字段的“值”是否包含特定关键词，您需要先获取该自定义字段的值，然后将该值作为 contain 过滤器的输入。例如，{{ archive.CustomFieldValue | contain:"关键词" }}。