在AnQiCMS模板中，动态地判断一个字符串是否包含特定的关键词是一个非常实用的功能，它能帮助我们在网站前端实现各种智能化的内容展示和交互逻辑。例如，你可以根据文章标题是否包含某个特定词语来展示不同的图标，或者在产品描述中高亮显示某些关键信息。

AnQiCMS采用了类似Django的模板引擎语法，提供了丰富的标签和过滤器来处理数据。要实现在模板中判断字符串是否包含特定关键词，我们可以借助一个非常方便的内置过滤器——contain。

核心工具：contain 过滤器

contain 过滤器是AnQiCMS模板系统中用于检测关键词存在性的一个强大工具。它的主要作用是判断一个目标字符串、数组、键值对（map）或结构体（struct）中是否包含你指定的关键词。最终，它会返回一个布尔值（True 或 False），清晰地告诉你关键词是否存在。

基本用法

contain 过滤器的使用方式非常直观，通常以管道符 | 连接到目标变量之后，并传入你想要检查的关键词：

{{ 目标变量 | contain:"关键词" }}

例如，如果我们要判断一个名为 articleTitle 的变量（代表文章标题）中是否包含“AnQiCMS”这个关键词，可以这样写：

{{ articleTitle | contain:"AnQiCMS" }}

如果 articleTitle 的值为“欢迎使用AnQiCMS内容管理系统”，那么上述代码的输出将是 True。

实际应用：在模板中判断与条件渲染

了解了contain过滤器的基本功能后，最常见的应用场景就是结合条件判断标签 {% if %} 来实现动态内容展示。

假设我们希望在文章标题中如果包含“教程”二字，就显示一个“新手教程”的徽章。我们可以这样实现：

{% set articleTitle = archive.Title %} {# 假设 archive.Title 是当前文章的标题 #}

<div class="article-header">
    <h1>{{ articleTitle }}</h1>
    {% if articleTitle | contain:"教程" %}
        <span class="badge badge-primary">新手教程</span>
    {% endif %}
</div>

在这个例子中：

  1. 我们首先使用 {% set %} 标签将文章标题赋值给一个名为 articleTitle 的变量，这有助于代码的清晰度和可维护性。
  2. 接着，在 {% if %} 语句中，我们应用了 articleTitle | contain:"教程" 来判断标题是否包含“教程”。
  3. 如果判断结果为 True，则 <span>新手教程</span> 这部分内容就会被渲染到页面上；如果为 False，这部分内容则不会显示。

更多场景：数组与复杂数据结构的判断

contain 过滤器的强大之处在于它不仅限于字符串，还可以应用于数组、键值对和结构体。

1. 判断数组中是否存在某个值

如果你有一个关键词列表（例如文章的标签列表 archive.Tags），并想检查其中是否包含某个特定的标签，contain 过滤器也能派上用场。

{% set articleTags = archive.Tags %} {# 假设 archive.Tags 是一个包含多个标签的数组，如 ["CMS", "模板", "教程"] #}

<div class="article-tags">
    标签：
    {% for tag in articleTags %}
        <span class="tag">{{ tag }}</span>
    {% endfor %}

    {% if articleTags | contain:"模板" %}
        <p>这篇文章与“模板”相关，可能对设计师有帮助！</p>
    {% endif %}
</div>

在这里，articleTags | contain:"模板" 会检查数组 articleTags 的元素中是否存在“模板”这个字符串。

2. 判断键值对（Map）或结构体（Struct）中是否存在某个键名

在处理一些自定义字段或复杂数据结构时，你可能需要判断某个键名（key）是否存在。contain 过滤器同样能满足这个需求。

假设我们有一个名为 customFields 的对象，它可能包含一些自定义设置，我们想检查它是否有 specialOffer 这个键：

{% set customFields = archive.CustomFields %} {# 假设 customFields 可能是一个包含多个自定义键值对的对象 #}

{% if customFields | contain:"specialOffer" %}
    <p>该产品目前有特别优惠！</p>
{% else %}
    <p>该产品暂无特别优惠。</p>
{% endif %}

此处的 customFields | contain:"specialOffer" 会检查 customFields 对象中是否存在名为 specialOffer 的键。

灵活运用，提升模板表现力

通过contain过滤器，我们可以轻松地在AnQiCMS模板中实现关键词的智能检测，从而让网站内容展示更加灵活和个性化。无论是进行条件渲染、数据筛选还是简单的内容校验，掌握这个过滤器都能大大提升你模板的表现力和可维护性。记住，结合 {% set %} 变量赋值和 {% if %} 条件判断，可以构建出清晰且功能强大的模板逻辑。

常见问题 (FAQ)

1. contain 过滤器是否区分大小写？

是的，contain 过滤器是区分大小写的。这意味着“AnQiCMS”和“anqicms”会被视为不同的关键词。如果你需要进行不区分大小写的判断，可以考虑先将目标字符串和关键词都转换为统一的大小写（例如全部转为小写），再进行比较。AnQiCMS模板提供了 lower 和 upper 过滤器来帮助你完成大小写转换。

2. 除了 contain，还有其他类似的功能可以用来处理字符串吗？

当然。AnQiCMS模板系统还提供了其他一些与字符串处理相关的过滤器，例如：

  • index：返回关键词在字符串或数组中首次出现的位置，如果不存在则返回 -1。
  • count：计算关键词在字符串或数组中出现的次数。
  • replace：将字符串中的某个关键词替换为另一个关键词。
  • cut：移除字符串中的指定字符。 这些过滤器可以根据具体需求，与 contain 过滤器配合使用，实现更复杂的字符串操作。

3. contain 过滤器可以判断文章的全部内容是否包含某个词吗？

可以的。如果你的文章内容存储在一个变量中（例如 archive.Content），你可以直接对这个变量使用 contain 过滤器来判断其是否包含特定的关键词。例如：{% if archive.Content | contain:"重要通知" %}。这在需要对文章内容进行初步筛选或在页面上显示内容摘要时非常有用。