在安企CMS的模板开发中，我们经常会遇到需要处理不同类型数据的情况。当涉及从HTML内容中提取特定属性值，例如data-items="item1|item2"，并希望进一步处理这些值时，`split`过滤器是一个非常实用的工具。然而，它的适用性并非直接针对HTML解析，而是作用于已获取到的字符串数据。

安企CMS模板与过滤器简介

安企CMS采用类似Django模板引擎的语法，这种设计让内容展示与业务逻辑分离，提高了模板的可读性和可维护性。在模板中，我们通过双花括号{{变量}}来输出变量值，通过{% 标签 %}来控制逻辑结构，而过滤器则以{{obj|filter__name:param}}的形式对变量值进行处理和格式化。

系统提供了丰富的内置过滤器，用于字符串处理、数字运算、时间格式化等多种场景。其中，split过滤器就是专门用于字符串操作的重要工具之一。

深入理解 split 过滤器

根据安企CMS的文档描述，split过滤器的核心功能是将一个特定格式的字符串按照指定的分隔符切割成一个数组（或称为切片）。它的基本用法是：

{{ 变量名|split:"分隔符" }}

例如，如果有一个字符串"apple,banana,orange"，使用split过滤器并以逗号和空格作为分隔符，可以得到一个包含"apple"、"banana"和"orange"的数组：

{% set fruits_string = "apple, banana, orange" %}
{% set fruits_array = fruits_string|split:", " %}
{# fruits_array 现在是：["apple", "banana", "orange"] #}

需要注意的是，如果指定的分隔符在原字符串中不存在，split过滤器会返回一个只包含原字符串本身且长度为1的数组。如果分隔符为空，它则会按每个UTF-8字符将字符串拆分成数组。

HTML属性值提取的挑战

现在我们回到核心问题：split过滤器是否适用于从HTML内容中提取data-items="item1|item2"这样的属性值？

答案是：直接从完整的HTML内容中提取属性值，`split`过滤器本身并非为此设计，它不具备HTML解析能力。

HTML内容本质上是一种结构化的标记语言，其中包含了标签、属性、文本等多种元素。模板引擎的过滤器通常侧重于对纯文本或已结构化数据进行操作，而不是进行复杂的HTML DOM解析。如果我们的目标HTML代码片段如<div data-items="item1|item2">...</div>是作为一个大的字符串存储在某个内容字段（比如文章详情archive.Content或页面内容page.Content）中，那么模板过滤器无法直接“找到”这个div标签，更无法直接“读取”它的data-items属性。

尝试在模板层面直接解析任意HTML并提取属性，不仅超出了大多数模板引擎的设计初衷，也可能引入安全风险和性能问题。

split过滤器的真正用武之地：处理已获取的字符串

那么，如何在安企CMS中有效地利用split过滤器来处理data-items="item1|item2"这类数据呢？关键在于确保data-items的属性值能够先以纯字符串的形式被获取到。

这通常可以通过以下两种更推荐的方式实现：

  1. 利用自定义内容模型和字段（推荐做法） 安企CMS的核心优势之一是其灵活的内容模型。我们可以为需要存储这类结构化数据的场景创建自定义字段，而不是将它们嵌入到普通的HTML内容（如富文本编辑器输出）中。

    例如，我们可以按照以下步骤操作：

    • 创建自定义字段： 在安企CMS后台的“内容模型”管理中（参考help-content-module.md），选择或创建一个模型（例如“文章模型”或“产品模型”），然后为其添加一个自定义字段。

      • 参数名： 可以是“数据项列表”或其他有意义的名称。
      • 调用字段： 建议使用英文小写字母，例如data_items_list。
      • 字段类型： 选择“单行文本”。
      • 默认值/填写内容： 在发布文章或产品时，在这个字段中直接输入item1|item2这样的纯字符串。

    • 在模板中获取并使用： 当我们发布了内容，并在自定义字段data_items_list中填入了item1|item2后，就可以在模板中轻松获取这个值了。我们可以通过archiveDetail或archiveParams标签（参考tag-archiveDetail.md和tag-archiveParams.md）来获取自定义字段的内容。

      {# 假设我们正在文档详情页，并且自定义字段的调用字段是 data_items_list #}
{% archiveDetail my_data_string with name="data_items_list" %}


{# 此时，my_data_string 的值就是 "item1|item2" #}
{% set data_array = my_data_string|split:"|" %}


{# 现在 data_array 是一个包含 ["item1", "item2"] 的数组，可以循环输出 #}
<ul>
{% for item in data_array %}
    <li>{{ item }}</li>
{% endfor %}
</ul>

      这种方式确保了数据的结构化存储，便于模板直接访问和处理，是安企CMS中处理此类需求的**实践。

  2. 前端JavaScript处理（当属性已在渲染的HTML中） 如果data-items属性已经存在于由安企CMS模板渲染输出的HTML页面中（例如，HTML结构是由模板的硬编码或富文本内容输出的，并且该属性在其中），那么最直接的方法是使用前端JavaScript来提取和处理这些值。

    ”`html 

    <!-- 其他内容 -->