在安企CMS的模板开发过程中，我们常常会遇到需要判断一个数组（slice）中是否包含某个特定值的场景。例如，你可能需要根据用户标签是否存在于某个预定义的标签列表中，来动态调整内容的展示；或者在处理复杂的业务逻辑时，判断某个权限ID是否存在于当前用户的权限集合中。对于这种需求，AnQiCMS的模板引擎提供了简洁而强大的解决方案，让开发者能够以优雅的方式处理这些逻辑。

在AnQiCMS的模板体系中，我们无需编写复杂的循环来逐一比对数组元素。得益于其内置的丰富过滤器，我们可以直接使用contain过滤器来轻松完成这项任务。这个过滤器设计得非常直观，其核心功能就是判断一个对象（可以是字符串、数组、Map或结构体）中是否存在某个“关键词”，并返回一个布尔值（True或False）。

深入理解contain过滤器

contain过滤器是AnQiCMS模板引擎中一个非常实用的工具，它能够高效地检查一个集合或字符串中是否包含指定的内容。当应用于数组（slice）时，它会检查数组中是否存在一个与你提供的“关键词”完全匹配的元素值。其返回的布尔值结果，可以直接用于模板中的条件判断（if语句），从而实现动态的内容展示。

实际操作：如何判断数组（slice）中是否存在某个值

让我们通过一个具体的例子来演示contain过滤器在判断数组（slice）中值是否存在时的用法。

假设我们在AnQiCMS的模板上下文中有一个名为user_tags的数组，它包含了当前用户所拥有的所有标签，例如：["VIP", "推广大使", "活跃用户"]。现在，我们想判断该用户是否拥有“VIP”标签。

{# 假设 user_tags 是一个包含用户标签的数组 #}
{% set user_tags = ["VIP", "推广大使", "活跃用户"] %}

{# 使用 contain 过滤器判断是否存在“VIP”标签 #}
{% if user_tags|contain:"VIP" %}
    <p>恭喜您，您是我们的尊贵VIP用户！</p>
    <a href="/vip-exclusive-content">查看VIP专属内容</a>
{% else %}
    <p>您还不是VIP用户，立即升级享受更多特权！</p>
    <a href="/upgrade-to-vip">升级VIP</a>
{% endif %}

在上面的代码中：

  1. 我们首先通过{% set user_tags = ["VIP", "推广大使", "活跃用户"] %}定义了一个名为user_tags的数组。在实际应用中，user_tags通常会由后端逻辑传递到模板。
  2. 接着，我们使用{% if user_tags|contain:"VIP" %}来进行条件判断。user_tags|contain:"VIP"这部分就是contain过滤器的应用，它会检查user_tags数组中是否存在字符串"VIP"。
  3. 如果存在，条件判断结果为True，则会显示“恭喜您，您是我们的尊贵VIP用户！”等内容。
  4. 如果不存在，条件判断结果为False，则会显示“您还不是VIP用户…”等内容。

这种写法避免了手动遍历数组的繁琐，使得模板代码更加简洁、易读且高效。

不仅仅是数组：contain过滤器的广阔应用场景

contain过滤器不仅对数组（slice）有效，它的强大之处在于其广泛的适用性。它可以应用于多种数据类型，以满足不同的判断需求：

  • 判断字符串中是否包含子字符串： 你可以检查一个较长的文本字符串中是否包含某个关键词。 
    
{% set article_title = "安企CMS：打造高效内容管理体验" %}
{% if article_title|contain:"CMS" %}
    <p>标题中包含关键词“CMS”。</p>
{% endif %}
  • 判断Map或结构体中是否包含某个键名： contain过滤器也可以用来检查一个Map（键值对集合）或结构体中是否存在指定的键名（key）。 
    
{% set product_info = {"name": "安企CMS", "version": "3.0", "price": 0} %}
{% if product_info|contain:"version" %}
    <p>产品信息中包含版本号。</p>
{% endif %}
    这里需要注意的是，当用于Map或结构体时，contain检查的是键名（key）是否存在，而不是某个值（value）是否存在于Map的任意键中。

总结

AnQiCMS模板引擎的contain过滤器为模板开发带来了极大的便利。它提供了一种声明式、高效且易于理解的方式来判断一个数组（slice）、字符串、Map或结构体中是否存在特定内容。通过灵活运用contain过滤器，我们可以编写出更具动态性、逻辑性更强的AnQiCMS模板，从而提升网站的交互体验和内容运营的效率。

常见问题（FAQ）

Q1: 如何判断数组中是否“不”包含某个特定值？ A1: 如果你想判断数组中是否不包含某个特定值，只需在contain过滤器的结果前加上not关键字即可。

{% set user_roles = ["Admin", "Editor"] %}
{% if not user_roles|contain:"Guest" %}
    <p>用户不是访客。</p>
{% endif %}

Q2: 除了判断是否存在，我还能获取这个值在数组中的具体“位置”吗？ A2: 可以的。你可以使用AnQiCMS模板引擎提供的index过滤器来获取某个值在数组（slice）或字符串中首次出现的位置。如果找不到，它会返回-1。

{% set product_ids = [101, 105, 110, 105] %}
{% set position = product_ids|index:105 %}
<p>值105在数组中首次出现的位置是：{{ position }}</p> {# 输出：1 (数组索引从0开始) #}

{% set not_found_position = product_ids|index:999 %}
<p>值999在数组中首次出现的位置是：{{ not_found_position }}</p> {# 输出：-1 #}

Q3: 如果数组中可能存在多个相同的值，我如何知道它出现了“多少次”？ A3: 你可以使用count过滤器来统计某个特定值在数组（slice）或字符串中出现的次数。

{% set status_list = ["pending", "approved", "rejected", "approved"] %}
{% set approved_count = status_list|count:"approved" %}
<p>“approved”状态出现了：{{ approved_count }} 次。</p> {# 输出：2 #}

{% set article_text = "AnQiCMS 是一个强大的CMS，AnQiCMS让内容管理更简单。" %}
{% set cms_count = article_text|count:"CMS" %}
<p>“CMS”在文本中出现了：{{ cms_count }} 次。</p> {# 输出：2 #}