如何使用`contain`过滤器在AnQiCMS模板中判断一个字符串或数组是否包含特定关键词？

在AnQiCMS构建网站的过程中，灵活地根据内容特性展示信息是提升用户体验和运营效率的关键。为了实现这一点，系统内置了许多实用的模板过滤器，其中contain过滤器便是判断内容是否包含特定关键词的得力工具。

它能帮助您在无需修改后端代码的情况下，直接在模板层面进行内容匹配，从而让您的网站内容展示更加智能化和个性化。

什么是contain过滤器？

contain过滤器是AnQiCMS模板系统中一个非常实用的内置功能，它能够判断一个字符串、数组（在Go语言中通常是切片Slice）、键值对（Map）甚至结构体（Struct）中，是否包含您正在寻找的特定关键词。

它的核心作用是进行“包含性”检查。当目标内容确实包含您指定的关键词时，contain过滤器会返回一个布尔值True；反之，如果未找到关键词，则返回False。这种简单明了的返回机制，让您能够轻松地在模板中进行各种条件判断和逻辑控制。

基础用法：判断字符串是否包含关键词

最常见的场景莫过于判断一段文本字符串中是否含有某个关键词。例如，您可能希望检查文章标题或摘要中是否提到了某个热门话题。

假设我们有一段介绍安企CMS的文字，想知道它是否提及了”CMS”：

{# 直接判断字符串中是否包含“CMS” #}
<p>这段文字是否包含“CMS”？
    {% if "欢迎使用安企CMS（AnQiCMS）"|contain:"CMS" %}
        <span>是，包含！</span>
    {% else %}
        <span>否，不包含。</span>
    {% endif %}
</p>

这段代码执行后，页面上会显示“是，包含！”因为字符串中确实含有”CMS”这个词。这里需要注意的是，contain过滤器是区分大小写的，如果您搜索“cms”，结果可能会是False，取决于原文的具体写法。

结合set标签，实现更灵活的逻辑控制

在实际应用中，我们通常不会直接在条件语句中写入大段的字符串。更常见的方式是，将待检查的变量内容或contain过滤器的结果存储起来，以便在复杂的模板逻辑中使用。这时，set标签就能派上用场。

例如，我们想根据文章标题是否包含“教程”来显示一个特别的标记：

{# 假设archive.Title是当前文章的标题 #}
{% set article_title = archive.Title %}
{% set is_tutorial = article_title|contain:"教程" %}

<h1 class="article-title">{{ article_title }}</h1>

{% if is_tutorial %}
    <span class="tag-tutorial">【教程】</span>
{% endif %}

<p>文章内容...</p>

通过set标签，我们将contain的判断结果赋给is_tutorial变量，这样就可以在模板的任何地方重复使用这个判断结果，而无需每次都重新计算。

进阶应用：判断数组或切片是否包含特定值

contain过滤器的强大之处不仅限于字符串。当您需要判断一个集合（如AnQiCMS中常用的数组或切片）是否包含某个特定元素时，它同样能发挥作用。

假设您文章有多个标签（Tag），存储在一个数组中，您想检查其中是否包含“SEO优化”这个标签：

{# 假设tags_list是通过|list过滤器从字符串转换而来的数组，或者直接是后端传来的数组 #}
{% set tags_list = '["安企CMS", "内容管理", "SEO优化", "多站点管理"]'|list %}

<p>文章标签列表：
    {% for tag in tags_list %}
        <span class="article-tag">{{ tag }}</span>
    {% endfor %}
</p>

{% if tags_list|contain:"SEO优化" %}
    <p class="seo-info">这篇文章与SEO优化相关，快来学习吧！</p>
{% else %}
    <p>这篇文章不包含SEO优化标签。</p>
{% endif %}

在这种情况下，contain过滤器会逐一检查数组中的每个元素，看是否有与”SEO优化”完全匹配的值。

更深入：判断键值对或结构体中是否存在特定键名

除了字符串和数组，contain过滤器还能处理更复杂的数据类型，比如键值对（map）或Go语言中的结构体（struct）。不过，这里有个重要的细节需要注意：在这种场景下，contain过滤器是判断这些数据结构中是否存在 指定名称的键（key），而不是判断某个 值 是否存在于这些键所对应的值中。

例如，您有一个产品详情的键值对，想检查它是否包含“price”这个键来决定是否显示价格信息：

{# 假设product_details是一个键值对或结构体 #}
{% set product_details = {'name': '安企CMS企业版', 'price': 999, 'features': ['多站点', 'SEO']} %}

<p>产品名称：{{ product_details.name }}</p>

{% if product_details|contain:"price" %}
    <p>产品价格：<strong>￥{{ product_details.price }}</strong></p>
{% else %}
    <p>该产品暂无公开价格。</p>
{% endif %}

这里，product_details|contain:"price"会检查product_details中是否存在一个名为price的键。如果存在，即返回True，显示价格。这对于动态显示不同类型产品或内容的不同属性非常有用。

实用场景举例：让网站内容更智能

contain过滤器的灵活运用能够带来许多实际好处：

1. 动态推荐与标识：如果文章标题包含“热门”、“新品”等关键词，可以动态展示“HOT”、“NEW”角标，吸引用户点击。
2. 个性化内容展示：根据文章所属分类的名称，动态加载不同的广告、推荐模块或样式。
3. 用户权限控制（结合用户组标签）：如果您使用AnQiCMS的用户组管理，可以判断当前用户的标签（Tag）是否包含“VIP”，从而决定是否显示VIP专属内容或下载链接。
4. 内容高亮与筛选：在搜索结果页中，如果搜索词出现在文章摘要里，可以将其高亮显示；或者根据用户选择的筛选条件，判断内容属性是否包含对应值。
5. 模板样式动态切换：某些页面元素可能需要根据其标题是否包含特定词汇来调整CSS样式，例如，标题含“联系”的导航项，为其添加特殊图标。

无论是简单的文本匹配，还是复杂的数组和数据结构判断，contain过滤器都以其直观的用法，为AnQiCMS的内容呈现带来了极大的灵活性和控制力。掌握它，您的网站运营将更加高效和智能。

常见问题 (FAQ)

1. contain过滤器是否区分大小写？ 是的，contain过滤器在进行关键词匹配时是区分大小写的。例如，如果您搜索“CMS”，那么“cms”或“Cms”将不会被匹配到。如果您需要进行不区分大小写的匹配，可以考虑在匹配前使用lower或upper过滤器将字符串统一转换为大写或小写再进行匹配。

2. contain过滤器能否判断一个键值对（map）或结构体（struct）中的某个 值 是否存在？ 不能。当contain过滤器用于键值对或结构体时，它只会判断是否存在指定的 键名（key），而不会去检查这些键所对应的值中是否包含某个特定的内容。如果您需要检查某个值是否存在于结构体或键值对的某个字段中，您需要先获取该字段的值，然后再对该值使用contain过滤器。例如：{{ product_details.name|contain:"企业" }}。

3. 如果我想判断多个关键词，contain过滤器怎么用？ 如果您需要判断目标内容是否包含多个关键词中的 任意一个 (OR逻辑)，或者 所有 关键词 (AND逻辑)，可以通过组合多个contain过滤器和if逻辑判断来实现。

• OR逻辑示例：{% if article.Title|contain:"教程" or article.Title|contain:"指南" %}
• AND逻辑示例：{% if article.Title|contain:"安企" and article.Title|contain:"教程" %} 您可以根据实际需求，灵活运用and、or这些逻辑运算符来构建更复杂的判断条件。