在使用安企CMS进行模板开发时，我们常常会遇到需要将文本片段或数字进行组合展示的场景。无论是构建动态的页面标题、拼接URL，还是在页面上进行简单的数值计算，灵活的数据处理能力都至关重要。安企CMS模板引擎提供了一个非常实用的工具——add 过滤器，它能够帮助我们轻松实现字符串的拼接和数字的相加操作。

什么是 add 过滤器？

add 过滤器是安企CMS模板中一个功能强大且灵活的内置过滤器，其核心作用在于执行“相加”操作。这里的“相加”不仅限于传统的数字运算，也包括了字符串的连接。这意味着您可以使用同一个过滤器来处理不同类型的数据，减少模板代码的复杂性。

add 过滤器在处理不同数据类型时具有智能的适应性。它会尝试根据输入值的类型进行自动转换和运算：

  • 当处理数字时：add 过滤器会执行标准的算术加法。
  • 当处理字符串时：add 过滤器会将两个字符串直接连接起来，形成一个新的字符串。
  • 当处理混合类型时：add 过滤器会尝试将其中一个值转换为兼容的类型以进行操作。如果无法成功转换并进行有效的加法或拼接，它通常会优雅地忽略无法处理的部分，或者按字符串形式进行拼接。
  • 当处理空值 (nothing/nil) 时：如果参与运算的值是空（或nil），add 过滤器在数字运算中通常将其视作 0；在字符串拼接中，则视作空字符串。如果空值导致操作无法进行，它会被忽略。

add 过滤器的基本使用方法

add 过滤器采用管道符 | 的方式应用到变量上，其基本语法结构如下：

{{ obj1|add:obj2 }}

其中，obj1 是您要操作的第一个值（可以是变量或字面量），add 是过滤器名称，obj2 是通过冒号 : 传递给过滤器的第二个值（同样可以是变量或字面量）。

例如，如果您想将数字 5 和 2 相加，可以这样写：

{{ 5|add:2 }}

这将在页面上显示 7。

add 过滤器在不同场景下的应用示例

为了更好地理解 add 过滤器的灵活性，我们来看一些具体的示例：

1. 数字相加

当两个操作数都是数字时，add 过滤器会执行常规的数学加法：

{{ 5|add:2 }}          {# 显示结果: 7 #}
{{ 5|add:40 }}         {# 显示结果: 45 #}

2. 字符串拼接

这是 add 过滤器在内容运营中最常用的场景之一，用于将不同的文本片段组合起来：

{{ "安企"|add:"CMS" }} {# 显示结果: 安企CMS #}
{{ "Hello, "|add:"world!" }} {# 显示结果: Hello, world! #}

3. 混合类型操作

add 过滤器在处理数字和字符串混合的场景时表现得非常智能。它会尝试将数字转换为字符串，然后进行拼接，或者将字符串转换为数字进行计算（如果字符串是有效的数字）：

{{ 5|add:"CMS" }}      {# 显示结果: 5CMS (数字5被转换为字符串'5'后与'CMS'拼接) #}
{{ "安企"|add:"2" }}   {# 显示结果: 安企2 (字符串'2'与'安企'拼接) #}

需要注意的是，如果字符串无法被解析为有效数字，则会按照字符串拼接的方式处理。

4. 处理空值 (nothing/nil)

当 add 过滤器遇到 nothing 或 nil 值时，它会根据上下文进行处理：

{% set emptyVar = nothing %}
{{ 5|add:emptyVar }}   {# 显示结果: 5 (emptyVar被视作0， 5+0=5) #}
{{ "前缀"|add:emptyVar|add:"后缀" }} {# 显示结果: 前缀后缀 (emptyVar被视作空字符串) #}

5. 更多综合示例

{# 假设我们有一个变量 article.Title = "安企CMS新功能" 和 article.CreatedYear = 2023 #}
{% set articleTitle = "安企CMS新功能" %}
{% set articleYear = 2023 %}
{% set authorName = "运营团队" %}

<p>标题：{{ articleTitle|add:" 发布于 " }}{{ articleYear }}</p>
{# 显示结果: 标题：安企CMS新功能 发布于 2023 #}

<p>作者：{{ authorName|add:" (CMS专家)" }}</p>
{# 显示结果: 作者：运营团队 (CMS专家) #}

<p>文章ID: {{ 100|add:"-ABC" }}</p>
{# 显示结果: 文章ID: 100-ABC #}

总结

add 过滤器是安企CMS模板中一个非常便捷且功能多样的工具，它在字符串拼接和数字相加方面提供了极大的便利。通过灵活运用 add 过滤器，您可以更高效地构建动态内容，优化页面展示，使模板代码更加简洁和易于维护。记住它的核心原则：数字相加，字符串拼接，混合类型智能处理，以及对空值的合理应对。

常见问题（FAQ）

1. add 过滤器可以同时拼接或相加多个值吗？

add 过滤器是二元操作符，也就是说它每次只能处理两个值。如果您需要拼接或相加三个或更多值，您需要将 add 过滤器连续使用。例如： {{ "A"|add:"B"|add:"C" }} 会先计算 "A"|add:"B" 得到 "AB"，然后再将 "AB"|add:"C" 得到 "ABC"。

2. 如果我只是想把两个字符串挨着显示，用 add 过滤器和直接写 {{str1}}{{str2}} 有什么区别？

对于纯粹的字符串拼接且不涉及数字运算的场景，直接写 {{str1}}{{str2}} 通常是更直接和推荐的做法。它表达的意图更清晰，即“将这两个字符串并排放置”。而 {{str1|add:str2}} 虽然也能达到相同的效果，但 add 过滤器更强调“相加”的概念，特别适用于当其中一个或两个值可能是数字，或者您希望过滤器能智能处理混合类型的情况。在仅为字符串拼接时，两者在最终输出上没有本质区别，但直接写 {} 更符合纯文本连接的语义。

3. add 过滤器在拼接字符串时，会自动添加空格或特殊字符吗？

不会。add 过滤器在拼接字符串时，只会将两个操作数的内容直接连接起来，不会自动添加任何额外的空格、连接符或其他特殊字符。如果您需要在拼接结果中包含空格、连字符等，您需要将这些字符作为字符串字面量明确地包含在操作数中，例如 {{ "Hello"|add:" "|add:"World" }}。