如何在模板中定义临时变量或使用宏函数来组织复杂的显示逻辑？

在使用安企CMS管理网站内容时，我们经常会遇到需要展示复杂数据或者重复使用相似布局的场景。如果不对模板中的显示逻辑进行有效组织，很快就会发现模板文件变得冗长、难以阅读，维护起来也特别吃力。幸运的是，安企CMS的模板引擎（它支持Django模板引擎语法）提供了定义临时变量和使用宏函数等强大工具，能够帮助我们优雅地解决这些问题，让模板代码既清晰又高效。

为什么需要更灵活的模板逻辑？

想象一下，你正在构建一个产品展示页面，每个产品卡片都需要显示产品图片、标题、价格和简短描述。如果每个卡片都重复编写这些内容的HTML结构和数据调用逻辑，那么当设计需要微调时，你就不得不在几十甚至上百个地方修改代码。更糟糕的是，如果你需要在一个复杂的数据循环中进行中间计算，或者从一个嵌套的数据结构中提取特定信息，直接堆砌逻辑会让模板变得像一团乱麻，任何一个小改动都可能引发意想不到的错误。

这时候，引入临时变量和宏函数就显得尤为重要。它们能帮助我们：

1. 提高代码可读性： 将复杂的数据处理步骤分解，用有意义的变量名表示中间结果。
2. 增强可维护性： 集中管理重复的显示逻辑，一处修改，多处生效。
3. 提升开发效率： 减少重复编写代码的时间，专注于业务逻辑的实现。
4. 优化性能： 避免不必要的重复数据查询或计算（尽管这更多是后端层面，但前端逻辑的清晰有助于整体优化）。

定义临时变量：让数据触手可及

在安企CMS的模板中，我们可以使用两种主要的方式来定义临时变量：{% with %}标签和{% set %}标签。它们各有侧重，可以根据具体需求灵活选用。

使用 {% with %} 标签来定义临时变量

{% with %}标签主要用于在一段代码块内，临时声明一个或多个变量。它的作用域仅限于这个with标签的内部，当代码执行到{% endwith %}时，这些临时变量就会失效。这使得它非常适合于将一个复杂表达式的结果赋值给一个易读的变量，或者为{% include %}引入的模板片段传递特定的上下文数据。

例如，我们可能需要在一个产品列表中，对价格进行简单的计算，然后再显示：

{% for product in productList %}
    {% with originalPrice = product.Price, discountRate = 0.8 %}
        {% set finalPrice = originalPrice * discountRate %}
        <div class="product-card">
            <h3>{{ product.Title }}</h3>
            <p>原价: ¥{{ originalPrice }}</p>
            <p>折扣价: ¥{{ finalPrice | floatformat:2 }}</p> {# 使用过滤器保留两位小数 #}
            <a href="{{ product.Link }}">查看详情</a>
        </div>
    {% endwith %}
{% endfor %}

在这个例子中，originalPrice和discountRate变量只在当前的product循环内部有效，使得计算过程更加清晰。

使用 {% set %} 标签来赋值变量

{% set %}标签则更像我们平时编程语言中的直接赋值操作。它允许你将一个表达式的结果赋值给一个变量，这个变量在当前模板文件或当前block内都是有效的，直到它被重新赋值。{% set %}通常用于存储单个值、从复杂对象中提取特定属性，或者进行一些需要跨越多个逻辑块使用的计算结果。

假设我们从一个archiveDetail标签中获取了多张图片，但只想显示第一张作为封面图：

{% archiveDetail archiveImages with name="Images" %}
{% if archiveImages %}
    {% set firstImage = archiveImages[0] %} {# 提取数组中的第一个元素 #}
    <div class="article-cover">
        <img src="{{ firstImage }}" alt="文章封面">
    </div>
{% else %}
    <div class="article-cover">
        <img src="{% system with name='SiteLogo' %}" alt="默认封面">
    </div>
{% endif %}

在这里，firstImage变量存储了文章的第一张图片地址，后续可以在该模板的其他地方继续使用它，而无需再次从archiveImages中提取。

封装复杂逻辑：宏函数（Macro）的妙用

当模板中出现大段重复的HTML结构和逻辑时，宏函数（Macro）就是你的救星。它允许你定义一个可重用的代码块，就像一个自定义的模板函数一样，接受参数，并根据参数输出内容。这极大地减少了代码冗余，并使模板更加模块化。

定义和使用宏函数

宏函数使用{% macro %}和{% endmacro %}标签来定义。你可以在宏函数的名称后定义它接受的参数，这些参数在宏函数内部可以像普通变量一样使用。

假设我们有一个通用的产品卡片布局，它在网站的多个地方都需要展示：

{# 定义在 partials/product_card.html 文件中 #}
{% macro render_product_card(product) %}
    <div class="product-card-item">
        <a href="{{ product.Link }}">
            <img src="{{ product.Thumb }}" alt="{{ product.Title }}">
            <h4>{{ product.Title | truncatechars:30 }}</h4>
            <p class="price">¥{{ product.Price | floatformat:2 }}</p>
        </a>
    </div>
{% endmacro %}

然后在需要使用这个产品卡片的地方，我们可以通过{% import %}标签导入宏文件，并调用宏函数：

{# 在 index.html 或 list.html 中使用 #}
{% import "partials/product_card.html" as cards %} {# 导入宏文件并起别名 #}

<div class="latest-products">
    <h2>最新产品</h2>
    <div class="product-grid">
        {% archiveList products with moduleId="2" type="list" limit="8" %}
            {% for item in products %}
                {{ cards.render_product_card(item) }} {# 调用宏函数，并传递产品数据 #}
            {% empty %}
                <p>暂无最新产品。</p>
            {% endfor %}
        {% endarchiveList %}
    </div>
</div>

通过宏函数，我们把产品卡片的显示逻辑封装起来，无论在哪个页面需要显示产品卡片，都只需一行代码调用，既简洁又统一。如果将来产品卡片的设计需要修改（比如添加一个“立即购买”按钮），只需修改partials/product_card.html这一个文件，所有引用它的地方都会自动更新，大大提升了维护效率。

结合实际场景：让模板更强大

将临时变量和宏函数结合使用，能让我们更灵活地组织复杂的显示逻辑。例如，在一个分类列表页面，我们可能需要遍历多个分类，并在每个分类下显示其最新的几篇文章。同时，每篇文章的显示方式又可以复用一个宏函数。

{% import "partials/article_item.html" as article_macros %} {# 导入文章宏函数 #}

<div class="category-sections">
    {% categoryList mainCategories with moduleId="1" parentId="0" limit="4" %}
        {% for category in mainCategories %}
            <div class="category-section">
                <h2><a href="{{ category.Link }}">{{ category.Title }}</a></h2>
                <div class="article-list">
                    {% archiveList articlesInCategory with categoryId=category.Id type="list" limit="5" %}
                        {% for article in articlesInCategory %}
                            {% with articleDate = stampToDate(article.CreatedTime, "2006-01-02") %} {# 临时变量格式化时间 #}
                                {{ article_macros.render_article_summary(article, articleDate) }} {# 调用宏函数，传递文章数据和格式化后的日期 #}
                            {% endwith %}
                        {% empty %}
                            <p>该分类暂无文章。</p>
                        {% endfor %}
                    {% endarchiveList %}
                </div>
            </div>
        {% endfor %}
    {% endcategoryList %}
</div>

在这个更复杂的场景中，{% set %}和{% with %}可以用来处理循环中的局部数据，而{% macro %}则专注于定义可复用的UI组件。再配合{% include %}和{% extends %}这些辅助标签