在安企CMS的强大模板系统中，灵活处理数据是构建动态网站的关键。很多时候，我们从后台获取的数据，例如标签、关键词或者自定义字段值，可能以逗号分隔的字符串形式存储，但我们希望在前端模板中将它们作为独立的项来处理。这时，安企CMS提供的list和split过滤器就显得尤为重要，它们能帮助我们将字符串转换为数组，从而在模板中进行更精细的控制和展示。

为什么我们需要将字符串转换为数组？

想象一下，你为一篇产品文章设置了多个标签，在后台可能保存为“手机,智能,通讯”。在模板中，你可能希望将这些标签分别显示，甚至为每个标签生成一个独立的链接或样式。如果数据仍然是一个整体的字符串，这将难以实现。通过将“手机,智能,通讯”转换为["手机", "智能", "通讯"]这样一个数组，我们就可以轻松地遍历这些元素，实现各种动态展示效果。

安企CMS的模板引擎支持Django风格的语法，提供了丰富的过滤器来处理这类数据转换需求。其中，split和list就是将字符串变为数组的利器。

split 过滤器：将字符串切割为数组

split 过滤器顾名思义，就是将一个字符串根据你指定的分隔符，切割成多个独立的字符串，并将它们组成一个数组。这对于处理后台以特定分隔符（如逗号、空格、竖线等）存储的多值字段非常有用。

使用方法：

在模板中，你可以这样使用split过滤器：

{% set rawString = "安企CMS,内容管理,模板定制,GoLang" %}
{% set stringArray = rawString | split:"," %}

这里，rawString是你要处理的原始字符串变量，split:","表示以逗号作为分隔符进行切割。执行后，stringArray就会变成一个包含["安企CMS", "内容管理", "模板定制", "GoLang"]的数组。

示例：处理文章标签

假设你的文章对象archive有一个Tags字段，其值为"SEO优化,网站建设,用户体验"。你可以在模板中这样显示这些标签：

{% set articleTags = archive.Tags | split:"," %}
<div class="article-tags">
    {% for tag in articleTags %}
        <span class="tag-item">{{ tag | trim }}</span>
    {% endfor %}
</div>

在这个例子中，trim过滤器还被用来去除可能存在的首尾空格，确保每个标签都干净整洁。

注意事项：

  • 分隔符灵活性： 分隔符可以是任意字符串，比如如果你用“ | ”分隔，就写split:" | "。
  • 分隔符不存在： 如果字符串中不包含指定的分隔符，split过滤器会返回一个只包含原始字符串的数组。
  • 空分隔符： 如果你将分隔符设置为空字符串split:""，那么split过滤器会将原始字符串的每一个字符（包括中文）都拆分成数组的一个元素。

list 过滤器：直接在模板中构造数组

与 split 过滤器侧重于“切割”现有字符串不同，list 过滤器提供了一种更直接、更结构化的方式来在模板中构造一个数组。它接受一个格式类似 JSON 数组的字符串，并将其解析成一个实际的数组对象。这在需要定义一组固定选项或进行一些预设值处理时非常方便。

使用方法：

list 过滤器接受一个双引号包裹的、内部符合JSON数组格式的字符串：

{% set allowedRoles = '["管理员", "编辑", "访客"]' | list %}

这里，allowedRoles就会被解析成一个包含["管理员", "编辑", "访客"]的数组。

示例：根据角色显示不同内容

如果你想根据当前用户的角色在页面上显示不同的操作选项，可以先定义一个允许操作的角色列表：

{% set editorActions = '["发布", "修改", "删除"]' | list %}
{% set currentUserRole = "编辑" %} {# 假设这是从某个地方获取的当前用户角色 #}

<ul class="actions-list">
    {% for action in editorActions %}
        {% if currentUserRole == "编辑" %} {# 示例，更复杂的判断逻辑可在此处展开 #}
            <li>
                <a href="/{{ action }}">{{ action }}操作</a>
            </li>
        {% endif %}
    {% endfor %}
</ul>

list 过滤器适合当你需要在模板中硬编码一些数组，或者从某个变量获取到的字符串严格遵守 JSON 数组格式时。

如何在模板中处理数组？

一旦通过 split 或 list 过滤器将字符串成功转换为数组，你就可以利用安企CMS模板引擎强大的循环功能来处理这些数组了。

使用 for 循环遍历数组：

最常用的方式就是使用 for 循环标签：

{% for item in yourArray %}
    {# 在这里处理每个数组元素 #}
    <span>{{ item }}</span>
{% empty %} {# 可选：如果数组为空则执行此部分 #}
    <p>没有可显示的项目。</p>
{% endfor %}

在循环内部，item变量会依次代表数组中的每个元素，你可以对其进行显示、条件判断或者结合其他过滤器进行进一步处理。

重新组合数组元素：join 过滤器

有趣的是，如果你在处理完数组后，又需要将数组元素重新组合成一个字符串（例如，为了显示在一个紧凑的文本段落中），join 过滤器正好能派上用场。它与 split 的功能正好相反。

{% set processedTags = ["安企CMS", "模板定制", "实用技巧"] %}
<p>相关主题：{{ processedTags | join:" | " }}</p>
{# 输出：相关主题：安企CMS | 模板定制 | 实用技巧 #}

额外提示：make_list 过滤器

如果你需要将字符串按单个字符拆分成数组，例如处理中文字符串或者字符游戏，make_list 过滤器会更方便。它会把字符串中的每一个字符（包括空格、标点和中文字符）都作为数组的一个独立元素。

{% set chineseString = "你好安企" %}
{% set charArray = chineseString | make_list %}
{# charArray 将会是 ["你", "好", "安", "企"] #}

<div class="chars-display">
    {% for char in charArray %}
        <span>{{ char }}</span>
    {% endfor %}
</div>

总结

掌握split和list过滤器，是安企CMS模板开发中的一项实用技能。split过滤器让你可以轻松地解析后台存储的多值字符串，而list过滤器则提供了一种直接在模板中定义数组的便捷方式。结合for循环和join过滤器，你将能够更灵活地控制和展示网站上的各种动态内容，从而为用户提供更丰富、更个性化的浏览体验。

常见问题 (FAQ)

1. split 和 make_list 过滤器有什么主要区别？

split 过滤器是根据你指定的“分隔符”来将字符串切割成子字符串数组。例如，"A,B,C" | split:"," 会得到["A", "B", "C"]。而 `make