在安企CMS的模板开发中，我们常常需要根据内容的特定属性或关键词来动态展示信息。例如，判断文章标题是否包含某个产品名称，或者检查一篇文档的标签列表中是否含有某个热门关键词。这不仅能让网站内容更具针对性，也能提升用户体验和SEO效果。

安企CMS的模板引擎提供了强大且灵活的功能来实现这些需求。其中，判断一个数组或字符串是否包含特定关键词，可以通过巧用内置的contain过滤器来轻松实现。

理解 contain 过滤器

contain 过滤器是安企CMS模板中一个非常实用的工具，它能够帮助我们判断一个值（字符串、数组、Go语言中的slice、map或struct）是否包含了另一个指定的值（即关键词）。这个过滤器在执行后会返回一个布尔值：如果包含，则返回 True；如果不包含，则返回 False。

它的基本使用方式非常直观：

{{ obj|contain:关键词 }}

在这里，obj 代表你想要检查的字符串或数组变量，而关键词则是你希望查找的目标。

实际应用场景：判断字符串中的关键词

假设您想检查一篇安企CMS文章的标题（archive.Title）是否包含了“安企CMS”这个品牌名称。您可以在模板中这样使用 contain 过滤器：

{% set articleTitle = archive.Title %} {# 获取当前文章的标题 #}

{% if articleTitle|contain:"安企CMS" %}
    <p>当前文章标题“{{ articleTitle }}”中包含了“安企CMS”这个词！</p>
{% else %}
    <p>当前文章标题“{{ articleTitle }}”中未包含“安企CMS”。</p>
{% endif %}

通过这种方式，您可以在文章列表中，为包含特定品牌关键词的文章添加特殊的标记或样式，吸引用户的注意力。同样地，如果您想检查文章内容（archive.Content）中是否存在某个特定短语，也可以采用相同的方法。不过，请注意 archive.Content 通常包含HTML，如果需要对纯文本进行搜索，可能需要先移除HTML标签（例如使用striptags过滤器），再进行关键词判断。

实际应用场景：判断数组中的关键词

在安企CMS中，很多数据以数组（或Go语言中的slice）的形式存在，例如文章的标签列表（tags）。如果您想判断某篇文章是否被打上了“营销”这个标签，可以这样操作：

首先，我们通过tagList标签获取文章的标签列表，并将其赋值给一个变量。然后，再使用contain过滤器检查这个列表中是否包含目标标签。

{% tagList currentArticleTags with itemId=archive.Id %} {# 获取当前文章的所有标签，赋值给currentArticleTags #}

{% if currentArticleTags|contain:"营销" %} {# 检查标签列表中是否包含“营销”这个字符串 #}
    <p>这篇文章被标记为“营销”类别。</p>
{% else %}
    <p>这篇文章没有“营销”标签。</p>
{% endif %}

值得注意的是，当contain过滤器用于数组时，它会检查数组中的每个元素是否与您提供的关键词完全匹配。

进阶用法：处理非标准数组数据

有时候，您自定义的字段可能存储的是一个以逗号或其他分隔符连接的字符串，而您希望将其视为一个“数组”来进行关键词判断。例如，您在文章模型中定义了一个名为relatedKeywords的自定义字段，存储格式为“关键词1,关键词2,关键词3”。

在这种情况下，您可以先使用split过滤器将这个字符串拆分成一个真正的数组，然后再使用contain过滤器进行判断：

{% set relatedKeywordString = archive.relatedKeywords %} {# 假设这是一个自定义字段 #}
{% set relatedKeywordArray = relatedKeywordString|split:", " %} {# 将字符串按", "拆分成数组 #}

{% if relatedKeywordArray|contain:"SEO" %}
    <p>这篇文档与SEO主题高度相关。</p>
{% else %}
    <p>这篇文档没有明确的SEO相关关键词。</p>
{% endif %}

这里，split:", " 表示以逗号和空格作为分隔符来拆分字符串。根据您实际使用的分隔符，您可以调整split过滤器后面的参数。

总结

contain过滤器是安企CMS模板中一个简单却功能强大的工具，它使得在模板层面对字符串和数组数据进行关键词判断变得非常便捷。无论是进行条件判断、动态内容展示，还是根据用户输入进行筛选，掌握这一过滤器都能让您的网站内容运营更加灵活高效。通过结合if逻辑标签以及split等辅助过滤器，您可以构建出更智能、更具交互性的网站功能，更好地满足访问者的需求。

常见问题解答 (FAQ)

  1. Q: 除了判断是否包含某个关键词，我还能统计这个关键词在字符串中出现的次数吗？ A: 当然可以。安企CMS模板提供了count过滤器来满足这个需求。您可以使用 {{ obj|count:关键词 }} 的方式来获取关键词在字符串或数组中出现的次数。例如，{{"安企CMS安企CMS"|count:"CMS"}} 将会返回 2。

  2. Q: 我只想知道关键词在字符串中的具体位置，而不是简单地判断它是否存在，有办法实现吗？ A: 有的。您可以使用index过滤器来查找关键词首次出现的位置。它会返回一个整数，表示关键词在字符串中的起始索引（从0开始计数）。如果关键词未找到，则返回-1。例如，{{"欢迎使用安企CMS"|index:"CMS"}}可能会返回18（取决于实际字符串的UTF-8编码长度）。

  3. Q: 如果我要判断的数组中包含的是对象（例如文章列表），contain过滤器还能直接判断对象属性的值吗？ A: contain过滤器在用于包含对象的数组时，会尝试将数组中的每个对象与您提供的关键词进行完全匹配。如果您的关键词是字符串，它只会检查数组中是否存在与该字符串完全相同的对象。若要判断对象属性（例如判断一个文章对象列表中是否存在Title为“某个标题”的文章），您需要遍历数组，并在循环中使用if语句单独检查每个对象的特定属性。例如：{% for item in articles %}{% if item.Title|contain:"某个标题" %}{# 逻辑 #}{% endif %}{% endfor %}。