如何在AnQiCMS模板中判断一个字符串是否包含某个子串？

在AnQiCMS的日常运营和模板设计中，我们常常需要根据内容的特定属性来决定如何展示它。比如，您可能希望突出显示文章标题中包含某个关键词的文章，或者根据产品描述中是否有特定字样来调整样式。这时，如何在模板中判断一个字符串是否包含另一个子串，就成了一个非常实用的技能。

AnQiCMS的模板系统基于Django模板引擎语法，提供了丰富的标签和过滤器来帮助我们灵活地处理数据。对于字符串的包含判断，我们可以巧妙地利用其中几个内置的过滤器。

核心方法一：利用 contain 过滤器直接判断

最直接且推荐的方法是使用 contain 过滤器。这个过滤器专门用于判断一个字符串、数组或映射（map/struct）中是否包含某个子串或键。它的返回值是一个布尔值（True 或 False），非常适合在条件判断中使用。

它的基本使用方式很简单，您只需要将要检查的字符串作为 obj，要查找的子串作为参数即可：

{{ obj|contain:"子串" }}

例如，假设我们有一个文章标题 archive.Title，想要判断它是否包含“CMS”这个词：

{% if archive.Title|contain:"CMS" %}
    <span style="color: red;">文章标题中包含“CMS”！</span>
{% else %}
    <span>文章标题中不包含“CMS”。</span>
{% endif %}

在上面的例子中，如果 archive.Title 的值是“欢迎使用安企CMS（AnQiCMS）”，那么页面就会显示“文章标题中包含‘CMS’！”。

contain 过滤器的强大之处还在于它的通用性。它不仅可以检查普通字符串，还能在数组（slice）和键值对（map/struct）中查找。

比如，如果您有一个文章标签数组 tags，想检查其中是否包含某个特定的标签：

{% set tags = "Go语言,内容管理,SEO优化"|split:"," %} {# 假设tags是一个字符串，我们先用split过滤器转换为数组 #}
{% if tags|contain:"SEO优化" %}
    <p>这篇文章与SEO优化相关。</p>
{% endif %}

或者，如果您有一个包含额外配置信息的映射 config，想判断某个键是否存在：

{% set extraConfig = { author:"AnQiCMS团队", release_date:"2023-01-01" } %}
{% if extraConfig|contain:"author" %}
    <p>作者信息已配置：{{ extraConfig.author }}</p>
{% endif %}

核心方法二：利用 index 过滤器辅助判断

除了 contain，index 过滤器也是一个非常有用的工具。index 过滤器会返回子串在目标字符串中第一次出现的位置（从0开始计数）。如果子串不存在，它会返回 -1。我们可以利用这个特性来间接判断子串是否存在。

它的基本使用方式如下：

{{ obj|index:"子串" }}

例如，我们依然使用文章标题 archive.Title：

{% if archive.Title|index:"CMS" != -1 %}
    <span style="font-weight: bold;">发现“CMS”字样，位置在 {{ archive.Title|index:"CMS" }}！</span>
{% else %}
    <span>未发现“CMS”字样。</span>
{% endif %}

虽然 index 也能实现相同的判断逻辑，但通常情况下，如果仅仅是为了判断是否存在，contain 过滤器会更简洁直观，也更符合语义。如果您需要获取子串的具体位置，那么 index 过滤器就是您的首选。

实用技巧与注意事项

1. 善用 {% set %} 标签： 当您进行复杂的判断或需要多次引用判断结果时，可以将过滤器的结果存储在一个变量中，这样可以提高模板的可读性和维护性：

   {% set hasSpecialKeyword = archive.Title|contain:"重要" %}
   {% if hasSpecialKeyword %}
       <span class="highlight-label">重要文章</span>
   {% endif %}
   

2. 大小写敏感性： 默认情况下，contain 和 index 过滤器都是大小写敏感的。这意味着“CMS”和“cms”会被视为不同的子串。如果您需要进行不区分大小写的判断，可以考虑先将字符串转换为统一的大小写再进行比较，例如：

   {% if archive.Title|lower|contain:"cms" %} {# 将标题全部转为小写后再判断 #}
       <span class="info">标题中不区分大小写包含“cms”</span>
   {% endif %}
   

3. 对中文的支持： AnQiCMS的过滤器对中文支持良好，无论是 contain 还是 index，都能正确处理中文字符串。

通过这些简单而强大的过滤器，您就可以在AnQiCMS模板中灵活地判断字符串是否包含特定子串，从而实现更动态、更智能的内容展示和页面逻辑。

常见问题 (FAQ)

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

是的，contain 过滤器默认是区分大小写的。例如，"AnQiCMS"|contain:"cms" 将返回 False。如果您需要不区分大小写地进行判断，建议先将原始字符串或子串通过 |lower 或 |upper 过滤器转换为统一大小写，然后再进行比较。

2. 我能否判断一个字符串是否包含多个子串中的任意一个？

当然可以。您可以将多个 contain 过滤器与 if 标签的 or 逻辑运算符结合使用。例如：

{% if article.Title|contain:"Go语言" or article.Title|contain:"AnQiCMS" %}
    <p>这篇文章与Go语言或AnQiCMS相关。</p>
{% endif %}

如果您需要判断是否包含所有指定的子串，则可以使用 and 运算符。

3. 除了字符串，contain 过滤器还能检查哪些数据类型？

contain 过滤器非常灵活，除了普通的字符串，它还可以检查：

• 数组（slice）：判断数组中是否存在某个值。
• 键值对（map）或结构体（struct）：判断是否存在某个键名（key）。 例如，["Apple", "Banana"]|contain:"Apple" 会返回 True，而 { "name":"Alice" }|contain:"name" 也会返回 True。