How to determine if a specific element is included in the array split by the `split` filter?

During content management and template development, we often encounter the need to process a string and then determine whether the processed result contains specific information.For example, a document may have multiple tags or categories, and this information is typically stored as a string connected by delimiters such as commas.When we need to decide the display style of the page based on these tags or categories, it is particularly important to judge whether it contains a specific element.

AnQiCMS provides powerful template tags and filters, making such operations simple and intuitive. This article will delve into how to utilizesplitfilter to split strings and combinecontainorindexA filter to determine if a split list contains a specific element.

Core function analysis:splitFilter

First, let's get to knowsplitA filter. Its main function is to split a string into a list according to a specified delimiter (commonly referred to as an array or slice in programming contexts).This is like us taking a long string of words separated by commas and splitting them into individual words.

Here is the basic usage:

{{ 你的字符串 | split:"分隔符" }}

For example, if your article tags are stored as a comma-separated string, we can use it like this.splitFilter:

{% set tags_string = "AnQiCMS,模板制作,SEO优化,内容营销" %}
{% set tag_list = tags_string | split:"," %}

{# 原始字符串：AnQiCMS,模板制作,SEO优化,内容营销 #}
<span>原始字符串：{{ tags_string }}</span>
{# 切割后的列表（为了方便显示，我们用join过滤器再次连接）：AnQiCMS | 模板制作 | SEO优化 | 内容营销 #}
<span>切割后的列表：{{ tag_list | join:" | " }}</span>

Here, tags_stringThis is the original string to be processed,split:","The result is split by commas.tag_listNow it is a list containing four elements, each of which is a label.

Check if an element exists:containThe wonder of filters

When you already have a list that is split bysplita filter, how can you efficiently determine whether this list contains the element you want? At this point,containThe filter comes into play.containThe filter can determine whether a string, list, map (map) or struct (struct) contains a specific keyword and directly returns a boolean value (trueorfalse)

containThe basic usage of the filter is as follows:

{{ 你的列表或字符串 | contain:"目标元素" }}

Now, we willsplitandcontainCombine the filters to determine if the split list contains the label 'SEO optimization':

{% set tags_string = "AnQiCMS,模板制作,SEO优化,内容营销" %}
{% set tag_list = tags_string | split:"," %} {# 将字符串切割成列表 #}

{% set has_seo_tag = tag_list | contain:"SEO优化" %} {# 判断列表中是否包含“SEO优化” #}

{% if has_seo_tag %}
    <span>这个内容包含了“SEO优化”标签。</span>
{% else %}
    <span>这个内容不包含“SEO优化”标签。</span>
{% endif %}

In the above code, we first obtained the article list throughsplittotags_stringtotag_listThen, usetag_list | contain:"SEO优化"Determine if the list contains the element "SEO optimization" and assign the result tohas_seo_taga variable. Finally, through aifstatement based onhas_seo_tagUsing a boolean value to display different content. This method is concise and clear, very suitable for conditional judgments.

Another approach:indexAuxiliary judgment of the filter

exceptcontainThe filter directly returns a boolean value, in addition, we can also useindexfilters to indirectly judge.indexThe filter will search for the target element in a string or list, and if found, will return the index of the first occurrence of the element, if not found, then return-1.

indexThe basic usage of the filter is as follows:

{{ 你的列表或字符串 | index:"目标元素" }}

UtilizeindexThe method to filter a list to check if it contains a specific element is to first get the position of the target element, then judge whether this position is not equal to-1(which means it is not not found).

{% set tags_string = "AnQiCMS,模板制作,SEO优化,内容营销" %}
{% set tag_list = tags_string | split:"," %} {# 将字符串切割成列表 #}

{% set seo_tag_position = tag_list | index:"SEO优化" %} {# 获取“SEO优化”在列表中的位置 #}

{% if seo_tag_position != -1 %}
    <span>“SEO优化”标签在列表中的位置是：{{ seo_tag_position }}。</span>
{% else %}
    <span>这个内容不包含“SEO优化”标签。</span>
{% endif %}

This method is similar tocontainThe filter effect is the same, but in some scenarios where it is necessary to know the specific location of the elements,indexthe filter has an advantage. If it is just to determine whether it exists,containthe filter will be more direct and recommended.

Scenario Application Example

Let's consider a more practical scenario: You are designing a product detail page template, where a product may have multiple features, which are stored as strings, such as"防水,防震,高清摄像头". If the product has the "waterproof" feature, a special icon should be displayed on the page.

{% set product_features_string = "防水,防震,高清摄像头" %}
{% set feature_list = product_features_string | split:"," %}

{# 判断是否包含“防水”特性 #}
{% if feature_list | contain:"防水" %}
    <span class="feature-icon feature-waterproof"></span>
    <p>该产品支持防水功能。</p>
{% endif %}

{# 判断是否包含“防震”特性 #}
{% if feature_list | contain:"防震" %}
    <span class="feature-icon feature-shockproof"></span>
    <p>该产品具备防震设计。</p>
{% endif %}

{# 循环显示所有特性 #}
<ul class="product-features-list">
    {% for feature in feature_list %}
        <li>{{ feature }}</li>
    {% endfor %}
</ul>

By using such an application, we can flexibly control the display logic of the front-end page based on the characteristics of the content without changing the way the back-end data storage is stored, greatly enhancing the dynamism and maintainability of the template.

Summary

MastersplitThe ability of the filter to split strings into lists and combine themcontainorindexThe filter's ability to determine if a specific element exists in a list, which is a very practical skill in AnQiCMS template development.containThe filter, with its intuitive boolean return value, is the preferred choice for determining the existence of elements; andindexThe filter is then used when it is necessary to obtain the specific position of an element.Apply these filters flexibly to your template, which will enable you to handle dynamic content more efficiently and meet diverse display requirements.

---

Frequently Asked Questions (FAQ)

Q1:splitWhat happens when a filter splits a string and the delimiter itself is part of the string? For example, using,split"A,B,,C".

A1: WhensplitWhen a filter encounters consecutive delimiters, it creates empty string elements between them. For example,"A,B,,C" | split:","The result will be["A", "B", "", "C"]which includes an empty string. When usingcontainorindexPay attention to the existence of this empty string when making subsequent judgments.

**Q2: How do I