在运营产品展示型网站时，你可能经常遇到需要精确显示产品价格的情况。一个专业且用户友好的网站，往往需要统一商品价格的显示格式，例如始终保留两位小数，即使是整数价格也自动补齐为 .00。AnQiCMS 以其灵活的模板系统，让这些细节处理变得非常便捷。
理解 AnQiCMS 模板中的数据与显示
AnQiCMS 的模板系统基于 Go 语言，但其语法风格与 Django 模板引擎非常相似，这使得熟悉网页开发的你能够快速上手。在 AnQiCMS 中，产品或任何带有价格属性的内容，通常会通过 archiveDetail（获取单个文档详情）或 archiveList（获取文档列表）等标签来获取数据。
例如，当你通过 archiveList 标签循环展示产品时，你可能会得到一个 item 对象，其中包含 item.Title（产品标题）和 item.Price（产品价格）等字段。此时，item.Price 可能是一个浮点数，比如 12.345、12.3 甚至是 12。我们的目标是无论原始数据如何，都让它以 12.35、12.30 或 12.00 的形式展示。
核心解决方案：使用过滤器（Filters）
在 AnQiCMS 模板中，处理变量的显示格式，我们主要依赖于强大的“过滤器”（Filters）功能。过滤器能够对输出的变量值进行各种处理，包括格式化、截取、转换等。针对浮点数价格保留两位小数的需求，AnQiCMS 提供了几个非常实用的过滤器。
方法一：floatformat 过滤器
floatformat 过滤器专门用于格式化浮点数，允许你指定需要保留的小数位数。
使用方式：
{{ item.Price|floatformat:2 }}
这里的 2 表示保留两位小数。
效果演示：
- 如果
item.Price是12.345，输出会是12.35(自动四舍五入)。 - 如果
item.Price是12.3，输出会是12.3。 - 如果
item.Price是12.00，输出会是12。 - 如果
item.Price是12，输出会是12。
可以看到，floatformat 在处理带有小数的数字时表现良好，但对于末尾为零的小数（如 12.30）或整数，它会省略小数点后的零，使其显示为 12.3 或 12。如果你希望即使是整数也强制显示两位小数（例如 12.00），那么就需要考虑另一种方法。
方法二：stringformat 过滤器（推荐）
stringformat 过滤器提供了更灵活的格式化能力，它类似于 Go 语言中的 fmt.Sprintf() 函数，允许你使用格式化字符串来精确控制输出。这对于始终保留两位小数的场景非常适用。
使用方式：
{{ item.Price|stringformat:"%.2f" }}
这里的 %.2f 是一个格式化字符串，它告诉模板引擎将浮点数（f）格式化为总共两位小数（.2），并且会自动补齐小数点后的零。
效果演示：
- 如果
item.Price是12.345，输出会是12.35(自动四舍五入)。 - 如果
item.Price是12.3，输出会是12.30。 - 如果
item.Price是12.00，输出会是12.00。 - 如果
item.Price是12，输出会是12.00。
stringformat 过滤器在需要严格保持两位小数的场景下尤为实用，因为它会强制补齐小数点后的零，使得价格显示更加统一和专业。
实际应用示例
假设你正在制作一个产品列表页的模板，你希望每个产品的价格都能规范地显示为两位小数。你可以这样组织你的模板代码：
<div class="product-list">
{# 获取产品列表，假设moduleId="2"代表产品模型，limit="5"限制显示5个产品 #}
{% archiveList products with moduleId="2" limit="5" %}
{% for item in products %}
<div class="product-item">
<a href="{{ item.Link }}" class="product-link">
{# 假设产品Logo存在 #}
{% if item.Logo %}
<img src="{{ item.Logo }}" alt="{{ item.Title }}" class="product-thumb">
{% endif %}
<h3 class="product-title">{{ item.Title }}</h3>
{# 使用 stringformat 过滤器确保价格始终显示两位小数 #}
<p class="product-price">价格: ￥ {{ item.Price|stringformat:"%.2f" }}</p>
{# 假设产品有简介，并希望截取显示 #}
<p class="product-description">{{ item.Description|truncatechars:100 }}</p>
</a>
</div>
{% empty %}
<p>暂无产品信息。</p>
{% endfor %}
{% endarchiveList %}
</div>
通过这段代码，无论你的产品价格在后台是如何存储的，前端页面都会以统一的两位小数格式展示，从而提升网站的专业度和用户体验。
总结
通过 floatformat 或 stringformat 这两个简单而强大的过滤器，你可以轻松控制 AnQiCMS 模板中浮点数价格的显示格式。在需要严格保持两位小数，甚至包括补齐 .00 的场景下，stringformat:"%.2f" 过滤器无疑是更推荐的选择，它能帮助你的网站呈现出更专业、更一致的视觉效果。
常见问题 (FAQ)
1. 为什么我需要让整数价格也显示为 10.00 这样的形式，而不是简单的 10？
在电商或金融等对价格显示有严格要求的网站中，统一的价格格式能够增强用户信任感和网站的专业度。将 10 显示为 10.00 可以避免潜在的误解（例如用户可能认为 10 是未完整显示的价格），并在视觉上保持所有商品价格的对齐和一致性，特别是在列表或表格中，