在安企CMS的日常内容运营中,用户提交的标签(Tag)常常面临一个常见的问题:格式不统一。有些用户习惯用逗号分隔,有些用分号,甚至可能用中文逗号或者直接用空格。这些不规范的输入,如果直接展示在网站前台,不仅影响美观,也可能降低标签的可用性,例如在生成标签云或进行SEO优化时造成困扰。

幸运的是,安企CMS强大的模板引擎提供了splitjoin这两个非常实用的过滤器,可以帮助我们高效地对用户输入的标签进行标准化处理。

标签输入的“标准化”挑战

想象一下,用户在后台输入标签时,可能会出现以下几种情况:

  • SEO, CMS, AnQiCMS (英文逗号加空格)
  • SEO;CMS;AnQiCMS (英文分号)
  • SEO,CMS,AnQiCMS (中文逗号)
  • SEO CMS AnQiCMS (空格)
  • SEO , CMS ; AnQiCMS (混合多种分隔符,且有额外空格)

我们的目标是,无论用户如何输入,都能将其处理成一个统一的格式,例如:一个干净的标签数组,或者一个用英文逗号加空格分隔的字符串,确保每个标签都是独立的、没有多余空格的有效词语。

split 过滤器:将字符串拆解为数组

split 过滤器顾名思义,就是将一个字符串按照指定的分隔符“切割”成一个数组(或称切片)。它的基本用法是:{{ 变量 | split:"分隔符" }}

例如,如果我们有一个字符串 rawTags = "SEO,CMS,AnQiCMS",我们可以这样使用 split 过滤器:

{% set rawTags = "SEO,CMS,AnQiCMS" %}
{% set tagArray = rawTags|split:"," %}
{# tagArray 现在是一个包含 ["SEO", "CMS", "AnQiCMS"] 的数组 #}

如果用户使用的是分号分隔,我们只需将分隔符改为分号:

{% set rawTags = "SEO;CMS;AnQiCMS" %}
{% set tagArray = rawTags|split:";" %}
{# tagArray 现在是一个包含 ["SEO", "CMS", "AnQiCMS"] 的数组 #}

但是,当用户输入变得复杂,比如 SEO, CMS; AnQiCMS, 网站优化 这样混合了多种分隔符和多余空格的情况时,直接使用一个分隔符可能无法完全拆解。这时,我们可以结合 replace 过滤器,先将所有不规范的分隔符统一替换成一种,再进行 split 操作。

例如,我们可以先将分号和中文逗号都替换成英文逗号:

{% set rawTags = "SEO, CMS; AnQiCMS, 网站优化" %}
{% set tempTags = rawTags|replace:";","," %} {# 将分号替换为逗号 #}
{% set tempTags = tempTags|replace:",","," %} {# 将中文逗号替换为逗号 #}
{% set tagArray = tempTags|split:"," %}
{# tagArray 此时可能包含 ["SEO", " CMS", " AnQiCMS", " 网站优化"],注意其中的空格 #}

通过这一步,我们已经把所有标签统一用英文逗号分隔开,虽然可能还残留一些多余的空格,但已经为下一步处理打下了基础。

join 过滤器:将数组重新连接为字符串

join 过滤器与 split 的作用恰好相反,它接收一个数组,并用指定的分隔符将数组中的所有元素连接成一个单一的字符串。它的基本用法是:{{ 数组 | join:"分隔符" }}

例如,如果我们有一个标签数组 tagArray = ["SEO", "CMS", "AnQiCMS"],我们可以这样使用 join 过滤器:

{% set tagArray = ["SEO", "CMS", "AnQiCMS"] %}
{% set tagString = tagArray|join:", " %}
{# tagString 现在是 "SEO, CMS, AnQiCMS" #}

组合使用 splitjoin 实现标签标准化

现在,让我们把这两个过滤器结合起来,实现用户标签的标准化处理。我们的目标是,无论用户输入什么格式的标签,都能将其最终显示为干净、统一的逗号加空格分隔的格式,或者逐个显示为独立的标签链接。

假设用户在后台的标签输入框中填写了:搜索引擎优化,CMS ;AnQiCMS ,Go语言

{% set userInputTags = "搜索引擎优化,CMS ;AnQiCMS ,Go语言" %}

{# 第一步:标准化分隔符。将分号和中文逗号替换为英文逗号 #}
{% set standardizedDelimiterTags = userInputTags|replace:";","," %}
{% set standardizedDelimiterTags = standardizedDelimiterTags|replace:",","," %}

{# 第二步:使用 split 过滤器将字符串拆分为数组。 #}
{% set tagArray = standardizedDelimiterTags|split:"," %}

{# 第三步:遍历数组,对每个标签进行清理(去除首尾空格),并输出。
   这一步可以直接用于生成独立的标签链接,或者为下一步的 join 做准备。 #}
<p>标准化后的标签:</p>
<ul>
{% for tagItem in tagArray %}
    {% set cleanTag = tagItem|trim %} {# 使用 trim 过滤器去除标签前后的空格 #}
    {% if cleanTag != "" %} {# 确保不是空标签 #}
        <li><a href="/tags/{{ cleanTag|urlencode }}" rel="tag">{{ cleanTag }}</a></li>
    {% endif %}
{% endfor %}
</ul>

{# 第四步(可选):如果需要一个统一的逗号分隔字符串来展示,可以使用 join 过滤器 #}
{% set finalDisplayTags = [] %}
{% for tagItem in tagArray %}
    {% set cleanTag = tagItem|trim %}
    {% if cleanTag != "" %}
        {% set finalDisplayTags = finalDisplayTags|add:cleanTag %} {# 将清理后的标签添加到新数组 #}
    {% endif %}
{% endfor %}
<p>统一格式的标签字符串:{{ finalDisplayTags|join:", " }}</p>

在上面的示例中,我们首先通过 replace 过滤器统一了分隔符,确保所有标签都通过英文逗号分隔。接着,split 过滤器将这个字符串拆解成一个初步的数组。在遍历这个数组时,我们对每个标签项使用了 trim 过滤器来去除多余的首尾空格,并通过 if cleanTag != "" 判断过滤掉因连续分隔符产生的空标签。

最后,我们展示了两种常见的用途:

  1. 生成独立的标签链接列表:直接在 for 循环中为每个清理后的标签生成 <a> 链接,方便用户点击浏览相关内容。
  2. 生成统一格式的标签字符串:如果需要在某个位置(例如文章页面的底部)显示一串整齐的标签,可以将清理后的标签重新收集到一个新数组中,再使用 join 过滤器以统一的格式(例如 ,)连接起来。

通过灵活运用 splitjoin 这两个简单而强大的过滤器,您可以轻松地处理安企CMS中用户输入的标签数据,使其在网站前台以统一、整洁且易