AnQiCMS模板如何自定义变量并赋值使用（with/set）？

在AnQiCMS模板中，灵活地自定义和使用变量是实现动态内容和高效模板复用的关键。AnQiCMS的模板语法借鉴了Django和Blade等流行模板引擎的特性，使得变量的定义和赋值直观且强大。本文将深入探讨with和set这两个标签，帮助您更好地在AnQiCMS模板中自定义变量并加以利用。

一、变量自定义的基石：理解模板语法的核心

在AnQiCMS模板中，您会频繁接触到两种核心语法结构：

  • 双花括号 {{ 变量 }}：用于直接输出变量的值。
  • 单花括号和百分号 {% 标签 %}：用于执行逻辑操作，如条件判断、循环、变量赋值等。

正是通过{% 标签 %}中的with和set，我们可以创建和管理模板内部的变量，从而实现更精细的内容控制和更灵活的布局设计。

二、with标签：为临时上下文注入数据

with标签主要用于创建一个临时的变量作用域，在这个作用域内定义的变量只在{% with %}和{% endwith %}之间有效。它最常见的用途是配合include标签，向被引入的模板片段传递特定数据，而无需污染全局模板环境。

工作原理：

当您使用with标签时，您实际上是在为接下来的一段模板代码定义一套临时的变量。这些变量会覆盖或补充当前作用域中同名的变量，但一旦{% endwith %}标签出现，这些临时变量就会被清除，模板恢复到之前的变量环境。

使用场景：

  • 向include的模板传递参数： 假设您有一个通用的header.html模板，其中包含网站标题和关键词。在不同的页面中，您可能希望这些值有所变化。

    {# index.html 页面 #}
{% with page_title="首页标题 - AnQiCMS" page_keywords="AnQiCMS, 模板, 变量" %}
    {% include "partial/header.html" with title=page_title keywords=page_keywords %}
{% endwith %}


{# partial/header.html 模板内容 #}
<head>
    <title>{{ title }}</title>
    <meta name="keywords" content="{{ keywords }}">
</head>

    在这个例子中，index.html通过with定义了page_title和page_keywords，然后将它们作为title和keywords传递给header.html。header.html只会在被引入时使用这些变量。

  • 为特定区块创建临时数据： 如果模板中有一小段复杂的逻辑或数据展示，您可以将其封装在with块中，避免变量名冲突，保持代码整洁。

    {% with featured_article_id=10 %}
    {# 在这里调用ID为10的特色文章数据 #}
    {% archiveDetail featured with name="Title" id=featured_article_id %}
    <h3>特色文章: {{ featured }}</h3>
{% endwith %}
{# featured_article_id变量在此处已失效 #}

注意事项：

  • with标签定义的变量只在其{% with %}和{% endwith %}之间有效。
  • 如果传递给include标签的变量名与with中定义的变量名相同，后者会覆盖前者。
  • with标签支持同时定义多个变量，以空格分隔key=value对。

三、set标签：构建灵活的本地变量

set标签是AnQiCMS模板中最常用也最直接的变量赋值方式。它允许您在模板的任意位置声明一个变量，并为其赋予一个值，这个变量会从定义位置开始，在当前模板的整个作用域中都可用（除非被更深层的作用域覆盖）。

工作原理：

set标签采用{% set 变量名 = 值 %}的简洁形式，直接将右侧的值赋给左侧的变量。这个值可以是字面量、其他变量、表达式的结果，甚至是过滤器处理后的数据。

使用场景：

  • 存储计算结果： 当您需要对数据进行计算或过滤，并将结果用于后续多次输出时，set标签非常方便。

    {# 假设item.CreatedTime是一个时间戳，您想将其格式化 #}
{% set publish_date = stampToDate(item.CreatedTime, "2006-01-02") %}
<p>发布日期: {{ publish_date }}</p>
<p>文章更新于: {{ publish_date }}</p> {# 可以多次使用 #}


{# 结合过滤器进行字符串处理 #}
{% set article_description = item.Description|truncatechars:100 %}
<p>摘要: {{ article_description }}</p>

    这里，publish_date和article_description变量通过set定义后，可以在模板中的任何后续位置被引用。

  • 处理复杂数据结构： 当您需要从一个复杂对象中提取特定数据，并简化其访问方式时，set可以派上用场。

    {# 假设 archive.Images 是一个图片URL数组，我们只想取第一张图 #}
{% set first_image = archive.Images|first %}
{% if first_image %}
    <img src="{{ first_image }}" alt="{{ archive.Title }}">
{% endif %}


{# 获取自定义字段 #}
{% set custom_author = archive.CustomFields.Author %}
{% if custom_author %}
    <p>作者: {{ custom_author }}</p>
{% endif %}

  • 作为条件判断的中间变量： 简化if语句的复杂度。

    {% set is_premium_user = user.Level >= 5 %}
{% if is_premium_user %}
    <p>欢迎尊贵的VIP用户！</p>
{% endif %}

注意事项：

  • set标签定义的变量，从定义行开始在当前模板的整个作用域中都可用。
  • 不像with，set不需要endset标签。
  • 如果多次使用set为同一个变量赋值，后面的赋值会覆盖前面的。

四、选择与运用：with与set的策略

理解了with和set的特性后，我们可以根据实际需求灵活选择：

  • 使用with：当您需要将一组特定的变量传递给一个被include的模板片段，或者为一小段模板代码创建一个临时的、独立的环境时，with是理想选择。它有助于封装变量，避免全局变量污染，增强模板的可维护性。
  • 使用set：当您需要在当前模板文件中创建、存储或处理变量，并计划在后续多个位置引用这些变量时，set更为实用。它在进行数据预处理、简化复杂表达式、储存中间计算结果等方面表现出色。

这两种标签并非互斥，它们可以很好地结合使用，共同构建出功能强大、结构清晰的AnQiCMS模板。

五、变量的输出与调试

无论您使用with还是set定义了变量，都可以通过双花括号{{ 变量名 }}来输出其值。

在模板开发过程中，