在安企CMS的模板开发中，灵活地定义和赋值变量是实现网站内容动态显示和个性化布局的关键。通过巧妙运用变量，我们能够临时调整内容的呈现方式，使得模板不仅能够承载基础的数据展示，还能根据特定条件呈现出丰富多彩的显示逻辑。本文将深入探讨如何在AnQiCMS模板中定义和赋值变量，以及它们在控制内容显示逻辑中的实际应用。

模板变量的基石：理解与运用

AnQiCMS的模板引擎采用了类似于Django的语法风格，这使得变量的定义和使用直观而高效。在模板中，我们通过双花括号 {{变量名}} 来输出变量的值。这些变量可能是系统预设的（如当前文章的标题 {{archive.Title}}），也可能是通过特定标签获取的数据集合（如导航列表 {{navs}}），更可以是我们在模板中根据需求临时定义的。

理解变量的作用域至关重要：有些变量在整个模板渲染周期中都可用，而有些则仅限于特定的代码块内。正是这种作用域的差异，赋予了变量在控制显示逻辑时极大的灵活性。

两种定义变量的方式：With与Set

在AnQiCMS模板中，我们主要有两种方式来定义和赋值变量，它们各有侧重，适用于不同的场景。

1. {% with ... %}：局部作用域的临时变量

{% with %}标签主要用于在模板的特定代码块内临时定义变量。它的特点是作用域被严格限定在 {% with ... %} 和 {% endwith %} 之间。这意味着一旦离开了这个代码块，这些变量就不再有效。这种设计非常适合那些只需要在局部调整显示逻辑，不希望变量污染全局作用域的场景。

基本用法：

你可以定义单个变量：

{% with pageTitle="这是我的自定义页面标题" %}
    <h1>{{ pageTitle }}</h1>
{% endwith %}

也可以一次性定义多个变量，它们之间用空格隔开，每个变量都采用 变量名="变量值" 的形式：

{% with pageTitle="我的产品页面" pageKeywords="产品,分类,详情" %}
    <head>
        <title>{{ pageTitle }}</title>
        <meta name="keywords" content="{{ pageKeywords }}">
    </head>
{% endwith %}

与{% include %}标签的结合：

{% with %}标签在与 {% include %} 标签结合使用时，能发挥出强大的模块化能力。当我们需要引入一个公共模板片段（如侧边栏、头部导航等），但又希望这个片段能根据当前页面的上下文动态显示不同的内容时，with就派上用场了。通过 with，我们可以向被引入的模板传递特定的变量，而这些变量仅在被引入的模板片段中有效。

例如，我们有一个通用的头部文件 partial/header.html，里面包含一个标题。在不同的页面引入时，我们希望它的标题有所不同：

{# 在基础模板或页面模板中引入header #}
{% include "partial/header.html" with pageTitle="首页 - 我的网站" pageKeywords="网站首页,最新内容" %}

在 partial/header.html 文件中，就可以直接使用这些传递过来的变量：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>{{ pageTitle }}</title>
    <meta name="keywords" content="{{ pageKeywords }}">
</head>
<body>
    {# 其他头部内容 #}
</body>
</html>

如果你只想让 include 的模板仅使用传递的变量，而不继承当前模板的所有变量，可以在 with 后加上 only： {% include "partial/header.html" with pageTitle="首页" only %}

2. {% set ... %}：更灵活的局部变量声明

除了 {% with %}，AnQiCMS还提供了 {% set %} 标签，它允许你在当前模板的任何位置声明变量。与 with 不同，set 定义的变量作用域从定义点开始，一直到模板渲染结束，或者直到被重新赋值。这为变量的动态调整提供了更大的灵活性。

基本用法：

{% set greeting = "欢迎来到AnQiCMS!" %}
<p>{{ greeting }}</p>

{# 你可以在后续代码中修改它的值 #}
{% set greeting = "祝您使用愉快！" %}
<p>{{ greeting }}</p>

{% set %} 尤其适合在循环内部或条件判断内部对变量进行累加、处理或重新赋值，并且希望这些变量在后续的代码中继续生效的场景。

例如，在一个商品列表中，你可能需要计算商品的总价，或者根据某个条件统计符合要求的商品数量：

{% set total_price = 0 %}
{% for product in products %}
    {% set total_price = total_price + product.Price %}
    {# 显示商品信息 #}
{% endfor %}
<p>商品总价：{{ total_price }}</p>

变量在显示逻辑中的核心作用

定义好变量只是第一步，它们真正的力量在于与条件判断和循环结构结合，从而临时控制内容的显示逻辑。

1. 结合条件判断 ({% if %})：按需显示内容

变量常常作为 {% if %} 标签的判断依据，决定页面的某个部分是否显示，或者显示哪种内容。

例如，你可以根据一个变量的值来显示不同的欢迎信息：

{% set isLogin = true %} {# 这个变量可能来自后端传递的用户登录状态 #}

{% if isLogin %}
    <p>欢迎回来，尊敬的用户！</p>
{% else %}
    <p>请<a href="/login">登录</a>或<a href="/register">注册</a>。</p>
{% endif %}

这在展示VIP用户专属内容、根据用户权限显示不同操作按钮或根据后台配置开启/关闭某些功能模块时非常有用。

2. 结合循环遍历 ({% for %})：控制列表呈现

在处理列表数据时，变量与 {% for %} 标签的结合是必不可少的。虽然 {% for %} 自身已经能够遍历数据，但我们可以通过变量来进一步控制循环的逻辑，比如改变循环内部的显示样式，或者在循环中根据变量值筛选数据。

假设你有一个文章列表，并且希望在某些特定文章标题前加上一个“推荐”标识：

{% set featured_article_ids = [101, 105, 112] %} {# 假设这些ID的文章是推荐文章 #}

{% for article in articles %}
    <li>
        {% if article.Id in featured_article_ids %}
            <span style="color: red;">[推荐]</span>
        {% endif %}
        <a href="{{ article.Link }}">{{ article.Title }}</a>
    </li>
{% endfor %}

这里，featured_article_ids这个变量就临时控制了文章列表的显示逻辑，让特定的文章获得了额外的视觉强调。

3. 巧用过滤器 (filters)：优化变量值

虽然过滤器不直接定义变量，但它们可以对变量的值进行处理，从而间接影响显示逻辑。例如，你可以使用 truncatechars 过滤器来限制文章简介的长度，保证页面布局整洁：

{% for article in articles %}
    <p>{{ article.Description|truncatechars:100 }} <a href="{{ article.Link }}">查看更多</a></p>
{% endfor %}

这里，truncatechars:100 过滤器处理了 article.Description 变量，确保输出的内容不超过100个字符，保持了显示的一致性。

实际场景案例：让变量活起来

想象一下，你正在为一个企业网站设计首页。通过变量，你可以轻松实现以下动态显示需求：

  • 首页焦点图（Banner）的显示数量： 你可以定义一个变量 {% set banner_limit = 5 %}，然后在调用Banner列表的标签时使用它：{% bannerList banners limit=banner_limit %}。这样，你只需要修改 banner_limit 的值，就能控制首页Banner的显示数量，而无需修改具体的列表标签参数。

  • 特定分类内容的突出显示： 在首页上，你可能想在新闻模块中，将“企业公告”分类下的最新文章以特殊样式显示。你可以定义 {% set notice_category_id = 7 %}，然后在循环新闻列表时，通过 {% if article.CategoryId == notice_category_id %} 来添加额外的样式或标识。

  • 根据用户权限显示不同功能： 如果你的网站有用户组管理功能，你可以获取当前登录用户的用户组信息，并将其存储在一个变量中，例如 {% set currentUserGroup = user.GroupId %}。然后，在模板中通过 {% if currentUserGroup == "VIP" %} 来显示VIP用户专属的服务入口或折扣信息。

总结：模板开发的高效利器

掌握AnQiCMS模板中变量的定义和赋值，并将其与条件判断、循环等控制结构相结合，是提升模板灵活性和可维护性的关键。无论是通过 {% with %} 来创建局部、临时的变量，还是利用 {% set %} 进行更广泛的变量声明与更新，这些技巧都能帮助你构建出高度动态化、响应用户需求的网站界面。合理