在安企CMS的模板开发中，灵活地控制内容的显示是提升网站用户体验和运营效率的关键。有时，我们可能需要判断一段文字、一个列表（数组）或者一个数据对象（Map/Struct）中是否包含了某个特定的关键词或属性。这时，安企CMS提供的 contain 过滤器便能大显身手，它能帮助我们轻松实现这种条件判断，让模板逻辑更加智能。

contain 过滤器是什么？

简单来说，contain 过滤器是一个非常实用的工具，它的主要作用是帮助我们判断一个字符串、数组（在Go语言中称为Slice）、键值对（Map）或结构体（Struct）中，是否存在我们所指定的关键词或键名。它的判断结果会直接返回一个布尔值：如果找到了，就是 True；如果没找到，就是 False。这使得我们可以在模板中基于这些判断结果来动态地调整内容的展示方式。

如何使用 contain 过滤器？

contain 过滤器的使用方式非常直观。它的基本语法是：

{{ obj|contain:关键词 }}

这里的 obj 代表你想要进行检查的变量，它可以是一个字符串、一个数组、一个键值对或一个结构体。而 关键词 则是你希望在 obj 中查找的内容。

接下来，我们通过几个常见的场景来深入了解 contain 过滤器的实际应用。

场景一：判断字符串中是否存在某个关键词

在很多情况下，我们可能需要根据文章标题、产品描述等文本内容是否包含特定词语，来决定是否显示一些特殊标记。

例如，如果你希望在一篇文章标题中查找“CMS”这个词：

{% set articleTitle = "欢迎使用安企CMS（AnQiCMS）" %}
{{ articleTitle|contain:"CMS" }}
{# 显示结果为 True #}

这个布尔值可以直接用于 if 语句，从而实现动态的内容展示：

{% set articleTitle = "安企CMS模板开发指南" %}
{% if articleTitle|contain:"CMS" %}
    <span style="color: blue;">[CMS相关]</span>
{% endif %}
<h1>{{ articleTitle }}</h1>
{# 如果 articleTitle 包含“CMS”，则会在标题前显示蓝色“[CMS相关]”标签。 #}

这样的用法可以帮助你在产品列表页，自动为包含“限时优惠”字样的商品添加促销标签，或者在文章列表中为包含“最新资讯”的标题加上醒目标识。

场景二：判断数组（列表）中是否存在某个值

当你有一个标签列表、分类名称列表或其他数据集合时，contain 过滤器能够帮你快速检查某个特定值是否存在于这个列表中。

假设你有一个文章的标签列表：

{% set articleTags = ["Go语言", "CMS", "SEO优化", "模板开发"] %}
{{ articleTags|contain:"CMS" }}
{# 显示结果为 True #}

{{ articleTags|contain:"Python" }}
{# 显示结果为 False #}

你可以利用这个特性，为包含特定标签的文章添加额外的功能按钮或样式：

{% set articleTags = ["Go语言", "CMS", "SEO优化"] %}
{% if articleTags|contain:"SEO优化" %}
    <p>这篇文章包含了“SEO优化”标签，可能对SEO策略有帮助！</p>
{% endif %}
{# 如果 articleTags 包含“SEO优化”，则会显示提示信息。 #}

这种方法非常适合用于权限控制（例如，只有VIP用户组ID在特定列表中才能访问）、动态筛选或者根据用户偏好显示相关内容。

场景三：判断对象（键值对/结构体）中是否存在某个键名

在处理从后台获取的数据对象时，有时你需要检查这个对象是否包含了某个特定的属性（键名），而不是属性的值。contain 过滤器在这里同样适用，但它会检查对象的“键名”是否存在。

比如你有一个文章对象，其中包含标题和作者信息：

{% set articleInfo = {Title:"安企CMS深度解析", Author:"运营小A", Views:1200} %}

{{ articleInfo|contain:"Author" }}
{# 显示结果为 True #}

{{ articleInfo|contain:"Category" }}
{# 显示结果为 False #}

这个功能在需要根据数据模型动态渲染表单或信息块时非常有用。例如，你可能只在文章对象包含 Author 键时才显示作者信息：

{% set articleInfo = {Title:"安企CMS深度解析", Author:"运营小A"} %}
{% if articleInfo|contain:"Author" %}
    <p>作者: {{ articleInfo.Author }}</p>
{% else %}
    <p>作者信息暂无。</p>
{% endif %}

这种灵活性让你能更好地应对后台数据结构的变动，避免因缺少某个字段而导致模板报错。

为什么 contain 过滤器如此重要？

contain 过滤器在安企CMS的内容运营中扮演着重要的角色，它让你的网站内容展现出更高的灵活性和动态性：

  • 个性化展示：根据内容的特定属性或关键词，为用户提供更精准、更个性化的信息。
  • 提升用户体验：通过条件判断，动态加载或隐藏页面元素，使界面更清爽，信息更聚焦。
  • 简化模板逻辑：避免了复杂的字符串操作或后台判断，直接在模板层完成简单的条件逻辑，提高了开发效率。
  • 降低维护成本：当内容策略调整或数据字段变化时，只需修改少量模板代码即可适应，无需深入后端。

掌握 contain 过滤器，意味着你拥有了在安企CMS模板中进行精细化内容控制的能力，能够更高效地实现各种复杂的展示需求，让你的网站更具竞争力。

常见问题 (FAQ)

1. contain 过滤器在判断时会区分大小写吗？ 是的，contain 过滤器在进行字符串和数组值匹配时是区分大小写的。例如，"AnQiCMS"|contain:"cms" 将返回 False，而 "AnQiCMS"|contain:"CMS" 则返回 True。如果你需要不区分大小写的查找，可以在使用 contain 之前，先将字符串转换为统一的大小写（例如全部转为小写），再进行判断。

2. 我可以用 contain 过滤器来检查一个字符串或数组中是否存在多个关键词（例如“关键词A”和“关键词B”都存在）吗？ contain 过滤器一次只能判断一个关键词。如果你需要同时检查多个关键词，你可以结合使用多个 contain 过滤器和逻辑运算符（如 and 或 or）来构建更复杂的条件。例如：

{% set text = "安企CMS是一个强大的系统" %}
{% if text|contain:"安企" and text|contain:"CMS" %}
    <p>同时包含了“安企”和“CMS”。</p>
{% endif %}

3. 如果我尝试用 contain 过滤器检查一个空字符串或空数组，它会返回什么？ 当 obj 是一个空字符串、空数组或空对象时，contain 过滤器将始终返回 False，因为它无法在其中找到任何指定的关键词或键名。在实际应用中，你可能需要先使用 if obj 或 if obj|length > 0 来判断 obj 是否为空，以避免不必要的判断，使代码逻辑更健壮。