How to split a string into an array with a specified delimiter?

Flexibly use string splitting in AnQiCMS templates: convert a specified string to an array

In daily content management, we often encounter scenarios where we need to separate and independently display multiple pieces of information stored in a single text field.For example, the keywords of a document may be stored in a string separated by commas, and you want to display these keywords as independent tags or links on the frontend page.splitFilters are the tools to solve such problems.

AnQiCMS uses a template engine syntax similar to Django, one of its core advantages being the provision of rich filters (filters) for various operations on variables.These filters can help us implement data formatting and conversion directly at the template level without involving complex programming logic.splitThe filter is just one of many practical filters, whose role is to split a string into multiple substrings based on a specified delimiter, and then organize these substrings into an array (usually represented as a slice in the Go language environment).

to usesplitA filter whose basic syntax is very intuitive: you need to pass the string variable to be processed through a pipe character|Pass tosplita filter, andsplituse a colon after the filter:Specify the string used as a delimiter. For example, suppose we have a variabledocument.KeywordsStored with keywords such as 'CMS, template, SEO, content management' and we hope to split it with ', ' (comma followed by a space) as the separator. Then, in the template, you can do it like this:

{% set keyword_string = document.Keywords %} {# 假设 document.Keywords 的值为 "CMS, 模板, SEO, 内容管理" #}
{% set keyword_array = keyword_string|split:", " %}

After the above operation,keyword_arrayThis variable now stores an array containing the four elements ["CMS", "template", "SEO", "content management"].

After you successfully split a string into an array, the next step is usually to traverse the array and display its content. In the AnQiCMS template,forLoop tags are very suitable for iterating over arrays. Combined withsplitfilters, you can easily present the split content one by one. For example, to display the abovekeyword_arrayThe keywords are displayed as items in an unordered list, and you can write the template code like this:

{% set keyword_string = document.Keywords %} {# 假设 document.Keywords 的值为 "CMS, 模板, SEO, 内容管理" #}
{% set keyword_array = keyword_string|split:", " %}

<p>文档相关关键词：</p>
<ul>
    {% for tag in keyword_array %}
        <li>{{ tag }}</li>
    {% endfor %}
</ul>

In practical applications, the substrings cut off may sometimes contain extra spaces (for example, if the delimiter is just a comma),Then,trimUse a filter to remove the extra spaces at the beginning and end of each substring. This will make your content more standardized and aesthetically pleasing:

{% set keyword_string = "CMS, 模板, SEO, 内容管理" %}
{% set keyword_array = keyword_string|split:", " %} {# 假设这里的分隔符是逗号和空格 #}

<p>文档相关关键词：</p>
<ul>
    {% for tag in keyword_array %}
        <li>{{ tag|trim }}</li> {# 使用 trim 过滤器清除多余空格 #}
    {% endfor %}
</ul>

This string splitting ability has a wide range of application scenarios in AnQiCMS content operation. For example, you can set the 'Features' field on the product detail page to be split by a specific symbol (such as|strings separated by ）, then cut and loop them in the template to display as product selling points; or, in some custom field, store multiple URLs of user-uploaded images,splitThe filter can convert these URLs into an array, thus enabling the cyclic display of multiple images.This method greatly enhances the flexibility of the template and the ability to dynamically generate content, making your website's content more interactive and visually appealing.

MastersplitThe use of filters means that you can create more dynamic and adaptable webpage layouts in AnQiCMS, effectively enhancing the quality of content presentation and operational efficiency.

---

Common Questions and Answers (FAQ)

1. Q: How to handle extra spaces that may be attached to each substring after splitting a string?

A:When usingsplitThe filter splits the string into an array and, if the characteristics of the original string or the delimiter cause the substrings at both ends to potentially contain extra spaces, you can apply to each substring while traversing the array.trimFilter.trimThe filter can effectively remove all whitespace characters from the beginning and end of a string. For example:{{ tag|trim }}.

2. Q: If the string to be split does not contain the specified delimiter,splitwhat will the filter return?

A:If the string to be split does not contain the delimiter you specified,splitThe filter does not throw an error but instead returns an array containing only the original complete string as its sole element. For example, ifmy_stringthe value is 'This is a single sentence' and you trymy_string|split:","，the result will be a container containing["这是一个单句"]using a comma as a delimiter.

3. Q: In AnQiCMS templates,splitdoes the filter support regular expressions as delimiters?

A:In the AnQiCMS templatesplitThe filter is designed to accept a plain string as a delimiter, it does not directly support regular expressions.This means you cannot use complex pattern matching for splitting.If your slicing requirements involve regular expressions, you may need to consider using certain processing features in the AnQiCMS backend (such as the content replacement tool) or custom development for more complex string preprocessing before passing the processed data to the template.