在使用安企CMS（AnQiCMS）进行网站内容管理时，模板的灵活性对于实现多样化的内容展示至关重要。很多时候，我们不仅仅需要直接输出数据，还需要根据业务逻辑对数据进行一些临时性的处理、计算或判断，这时候，在模板中定义临时变量就显得尤为实用。这不仅能让模板代码更加整洁，还能避免重复获取或计算相同的数据，从而提升渲染效率和可维护性。

安企CMS的模板引擎语法与Django模板引擎相似，提供了强大的变量定义和逻辑控制能力，其中定义临时变量主要可以通过 {% with %} 和 {% set %} 这两个标签来实现。理解它们的用法和作用域，能帮助我们更好地构建复杂且富有表现力的网站模板。

使用 {% with %} 标签：局部作用域的临时变量

{% with %} 标签主要用于在模板的特定区块内临时定义一个或多个变量。它创建的变量只在该 {% with %} 和 {% endwith %} 块之间有效。它的一个典型应用场景是为 {% include %} 标签引入的子模板传递额外的变量，而这些变量可能并非全局可用或需要临时计算得出。

语法结构：

{% with variable_name = "值" %}
    <!-- 在这里使用 {{ variable_name }} -->
{% endwith %}

或者同时定义多个变量：

{% with var1 = value1 var2 = value2 %}
    <!-- 在这里使用 {{ var1 }} 和 {{ var2 }} -->
{% endwith %}

实际应用示例：

假设你有一个公共的头部模板文件 partial/header.html，其中需要显示一个动态生成的标题和关键词，而这些信息在每个页面可能有所不同。你可以这样做：

  1. 在主模板中定义并传递：

    {% set page_specific_title = "我们的产品详情" %}
{% set page_specific_keywords = "产品,详情,安企CMS" %}


{% with custom_title = page_specific_title custom_keywords = page_specific_keywords %}
    {% include "partial/header.html" with custom_title custom_keywords %}
{% endwith %}


<main>
    <!-- 页面主体内容 -->
</main>

  2. 在 partial/header.html 中使用：

    <head>
    <title>{{ custom_title }}</title>
    <meta name="keywords" content="{{ custom_keywords }}">
    <!-- 其他头部元素 -->
</head>

    通过 {% with %}，你可以确保 custom_title 和 custom_keywords 这两个变量只在 header.html 及其所在的 {% with %} 块中有效，避免了变量名冲突，并保持了代码的模块化。

此外，你也可以在 {% with %} 块内进行一些临时性的逻辑判断，例如：

{% with is_new_product = (product.CreatedTime > (now|date:"U") - 86400) %} {# 假设判断是否为24小时内发布的新产品 #}
    {% if is_new_product %}
        <span class="badge new-product">新品上市！</span>
    {% endif %}
    <h3>{{ product.Title }}</h3>
{% endwith %}

使用 {% set %} 标签：当前模板内的灵活声明

{% set %} 标签则允许你在当前模板文件中声明一个变量，并且这个变量在声明之后，可以在当前模板的任何地方（包括内嵌的 {% block %} 或 {% for %} 循环中）被访问和使用，直到模板渲染结束。它的作用域比 {% with %} 更广，适用于需要在当前模板内多次使用或进行复杂计算的场景。

语法结构：

{% set variable_name = "值" %}
<!-- 在当前模板的后续部分使用 {{ variable_name }} -->

实际应用示例：

  1. 简化复杂表达式： 当你需要从一个嵌套较深的对象中多次提取某个值时，使用 {% set %} 可以大大简化代码。

    {% set category_name = archive.Category.Title %}
<p>所属分类：<a href="{{ archive.Category.Link }}">{{ category_name }}</a></p>
<p>您正在浏览的文档位于 "{{ category_name }}" 分类下。</p>

  2. 存储过滤器处理后的结果： 安企CMS提供了丰富的过滤器，如果你需要对同一个数据进行多个过滤操作，并将最终结果存储起来，{% set %} 是理想的选择。

    {% set brief_description = archive.Description|striptags|truncatechars:100 %}
<p>{{ brief_description }} <a href="{{ archive.Link }}">查看更多</a></p>

    这里，我们先移除了 Description 中的HTML标签，然后截取了前100个字符，并将处理后的结果赋值给 brief_description。

  3. 在循环中进行累计计算： 如果你在一个 {% for %} 循环中需要对某些数据进行累计计算，{% set %} 可以帮助你实现。

    {% set total_price = 0 %}
{% for item in cart.Items %}
    <p>{{ item.Name }} - 数量：{{ item.Quantity }} - 单价：{{ item.Price }}</p>
    {% set total_price = total_price|add:(item.Quantity * item.Price) %} {# 使用add过滤器进行数值累加 #}
{% endfor %}
<p>购物车总价：{{ total_price }}</p>

何时使用哪个？

选择 {% with %} 还是 {% set %}，主要取决于你对变量作用域的需求：

  • 使用 {% with %}： 当你只需要在特定的代码块内（例如，一个 <div> 标签内部的复杂逻辑，或者要传递给 {% include %} 的子模板）使用临时变量时。这有助于保持变量的局部性，避免不必要的全局污染。
  • 使用 {% set %}： 当你需要在当前模板文件内更广泛的范围中使用一个变量，或者需要进行连续的计算和数据转换时。它提供了一种在模板中定义和重用复杂值的方式。

总而言之，{% with %} 更强调变量的“临时性”和“局部性”，而 {% set %} 则更侧重变量在当前模板内的“声明”和“复用”。熟练运用这两个标签，将让你的安企CMS模板开发变得更加高效和有条理。

常见问题 (FAQ)

Q1: {% with %} 和 {% set %} 定义的变量有什么本质区别？

A1: 它们最主要的区别在于变量的作用域。{% with %} 定义的变量只在其自身的 {% with %} 到 {% endwith %} 块内部有效，或者在它通过 with 参数传递给 {% include %} 的子模板中有效，属于局部作用域。而 {% set %} 定义的变量在它被声明之后，可以在当前模板文件的任何后续位置使用，包括它所在的任何循环或条件判断中，直到当前模板文件渲染结束。

Q2: 我可以在 {% for %} 循环中定义 {% set %} 变量并进行累加操作吗？

A2: 当然可以。{% set %} 变量非常适合在循环中进行累计、计数或其他迭代过程中的数据处理。如文章示例所示，你可以初始化一个 {% set total_price = 0 %} 变量，然后在循环体内通过 {% set total_price = total_price|add:item.price %} 这样的方式进行累加。

Q3: 如果我定义了一个临时变量，但它可能没有值（例如，一个对象属性不存在），会报错吗？我该如何处理？

A3: 安企CMS的模板引擎在访问不存在的变量或对象属性时通常不会直接报错，而是将其视为空值（如空字符串或零）。但为了代码的健壮性和避免意外显示，你可以使用 default 或 default_if_none 过滤器为其设置默认值。例如：{% set username = user.Name|default:"匿名用户" %}，这样即使 user.Name 不存在，也会显示“匿名用户”。