在AnQiCMS中，模板是展示网站内容的基石。灵活运用模板，不仅能让内容展示更加丰富多彩，还能通过一些内置的功能实现动态效果。其中，直接在模板中进行算术运算，是许多用户可能忽略但却非常实用的一个功能。它允许我们在不编写额外后端代码的情况下，直接在前端模板中处理数字，进行加减乘除等操作，从而实现更多动态的显示效果或逻辑判断。

AnQiCMS的模板系统借鉴了Django模板引擎的语法，这使得其在处理变量、逻辑控制以及算术运算方面都表现出高度的灵活性和直观性。下面，我们将详细探讨如何在AnQiCMS模板中直接进行这些算术运算。

一、基本算术运算

在AnQiCMS模板中，你可以像在普通编程语言中一样，使用加（+）、减（-）、乘（*）、除（/）以及取模（%）运算符。这些操作符可以直接作用于数字类型的变量或常量。

  • 加法（+）和减法（-） 它们是最基础的运算，用于求和或求差。

    {{ 10 + 5 }} {# 输出 15 #}
{{ 20 - 7 }} {# 输出 13 #}
{% set itemPrice = 100 %}
{% set discount = 15 %}
商品的最终价格是：{{ itemPrice - discount }} {# 输出 85 #}

  • 乘法（*）和除法（/） 用于计算乘积或商。需要注意的是，整数除法和浮点数除法的结果可能不同。

    {{ 4 * 6 }} {# 输出 24 #}
{{ 10 / 3 }} {# 如果两个操作数都是整数，结果可能被截断为整数，输出 3 #}
{{ 10 / 3.0 }} {# 至少一个操作数是浮点数时，结果会保留小数，输出 3.333333 #}
{% set viewCount = 500 %}
{% set factor = 0.1 %}
阅读量得分：{{ viewCount * factor }} {# 输出 50.0 #}

    为了确保得到浮点数除法结果，建议将其中一个操作数明确写为浮点数（例如 3.0），或使用后续提到的float过滤器进行类型转换。

  • 取模（%） 取模运算返回两数相除的余数，这在模板中常用于实现例如列表项的交替样式（奇偶行）等场景。

    {{ 10 % 3 }} {# 输出 1 #}
{% for item in archiveList %}
    <div class="item-{% if forloop.Counter % 2 == 0 %}even{% else %}odd{% endif %}">
        {# ... 内容 ... #}
    </div>
{% endfor %}

二、复合表达式与优先级

当你需要在一个表达式中混合使用多种运算时，可以使用括号 () 来明确运算的优先级。和数学中的规则一样，括号内的运算会优先执行。

{{ (10 + 5) * 2 }} {# 先计算 10+5=15，再乘以2，输出 30 #}
{{ 10 + 5 * 2 }} {# 先计算 5*2=10，再加10，输出 20 #}
{% set basePrice = 50 %}
{% set taxRate = 0.1 %}
{% set shippingCost = 5 %}
总价：{{ basePrice * (1 + taxRate) + shippingCost }} {# 输出 50 * 1.1 + 5 = 55 + 5 = 60 #}

三、比较与逻辑运算

除了算术运算，AnQiCMS模板还支持比较运算符和逻辑运算符，这些在进行条件判断时非常有用。

  • 比较运算符 用于比较两个值的大小或是否相等，返回布尔值（true 或 false）。

    • 相等：==
    • 不相等：!=
    • 小于：<
    • 大于：>
    • 小于或等于：<=
    • 大于或等于：>=
    {% set currentNum = 10 %}
{% if currentNum > 5 %}
    数字大于5
{% endif %}
{% if currentNum == 10 %}
    数字等于10
{% endif %}

  • 逻辑运算符 用于组合多个条件，返回布尔值。

    • 与：and (或 &&)
    • 或：or (或 ||)
    • 非：not (或 !)
    {% set isVip = true %}
{% set userLevel = 3 %}
{% if isVip and userLevel > 2 %}
    高级VIP用户
{% endif %}
{% if not isVip or userLevel < 1 %}
    非VIP或低等级用户
{% endif %}

  • 成员运算符（in / not in） 用于检查一个值是否存在于一个列表、数组或字典（map/struct）中，或者检查一个键是否存在于字典中。

    {% set colorList = ["red", "green", "blue"] %}
{% if "red" in colorList %}
    列表中包含红色
{% endif %}


{% set productTags = {"new": true, "sale": false} %}
{% if "new" in productTags %} {# 检查键是否存在 #}
    新品标签存在
{% endif %}

四、结合实际数据进行运算

算术运算最强大的地方在于能够结合AnQiCMS的内置标签获取到的动态数据进行处理。例如，你可能需要根据文章的浏览量计算一个“热度”得分，或者根据产品价格进行汇率转换。

{# 假设 archive.Views 是文章的浏览量，archive.Id 是文章ID #}
{% set hotScore = archive.Views * 0.05 + archive.Id * 0.01 %}
<p>文章热度得分：{{ hotScore }}</p>

{# 假设 product.Price 是产品价格，需要显示加税后的价格 #}
{% set productPrice = product.Price %}
{% set taxRate = 0.08 %} {# 8%的税率 #}
<p>含税价格：{{ productPrice * (1 + taxRate) }}</p>

{# 假设有一个自定义字段 item.stock 表示库存，当库存低于10时显示“库存紧张” #}
{% if item.stock <= 10 and item.stock > 0 %}
    <span style="color: orange;">库存紧张！剩余 {{ item.stock }} 件</span>
{% elif item.stock == 0 %}
    <span style="color: red;">已售罄</span>
{% else %}
    <span>库存充足</span>
{% endif %}

通过上述示例，我们可以看到，在AnQiCMS模板中直接进行算术和逻辑运算，能够极大地提升模板的表达能力和动态性，减少对后端逻辑的依赖，让前端页面更加灵活智能。

实用建议

  • 保持简洁： 尽管模板支持复杂的运算，但建议保持模板中的逻辑尽可能简洁。过于复杂的计算和业务逻辑仍然更适合放在后端处理。
  • 注意数据类型： 在进行除法等可能涉及小数的运算时，确保至少有一个操作数是浮点数，以避免整数除法造成的精度丢失。AnQiCMS也提供了float和integer过滤器，可以显式地进行类型转换，例如 {{ some_var|float * 0.1 }}。
  • 充分测试： 任何在模板中进行的运算，尤其是在生产环境中，都应经过充分的测试，确保结果符合预期，避免因计算错误导致的用户体验问题。

常见问题 (FAQ)

1. 我能否将通过AnQiCMS标签获取到的变量直接用于算术运算？ 是的，完全可以。例如，如果你通过{% archiveDetail with name="Views" %}获取到文章的浏览量，你可以将它赋值给一个变量，然后直接在表达式中使用：{% set views = archive.Views %}{{ views * 0.5 }}。An