在odoo qweb模板中，当需要将浮点数转换为整数并显示时，常见的错误是使用`t-value`指令。本文将详细解释`t-value`与`t-esc`指令的核心区别，指出`t-value`主要用于设置属性或变量，而`t-esc`才是用于安全地在html中渲染动态内容的正确方法。通过正确的指令`t-esc`结合python的`int()`函数，可以确保转换后的整数值被正确显示，并避免潜在的xss风险。
QWeb中浮点数到整数转换的常见问题
在Odoo的QWeb报告或视图开发中，经常会遇到需要对数据进行类型转换并显示的需求。例如，将数据库中存储的浮点数字段（如doc.total_mesin_jalan）转换为整数后展示。开发者可能会尝试使用如下代码：
<span t-value="int(doc.total_mesin_jalan)"/>
然而，这种做法会导致一个问题：转换后的整数值并不会在最终的HTML输出中显示出来，只会显示其他静态文本（例如示例中的“%%”），而期望的数字内容缺失。
t-value与t-esc的核心区别
理解QWeb中t-value和t-esc指令的正确用法是解决此问题的关键。
-
t-value指令的作用t-value指令主要用于两种场景：
-
设置QWeb变量： 当与<t t-set="variable_name" ... />结合使用时，它用于将表达式的值赋给一个QWeb变量，供后续模板逻辑使用。
<t t-set="total_machines" t-value="int(doc.total_mesin_jalan)"/> <!-- 之后可以使用 total_machines 变量 -->
-
设置HTML属性： 当与t-att-attribute_name结合使用时，它用于动态设置HTML元素的属性值。
<div t-att-id="doc.id" t-att-class="'my-class ' + doc.status"/>
重要提示： t-value本身并不会将表达式的结果直接渲染到HTML元素的内部内容中。它是一个赋值或属性设置指令，而非内容输出指令。
-
设置QWeb变量： 当与<t t-set="variable_name" ... />结合使用时，它用于将表达式的值赋给一个QWeb变量，供后续模板逻辑使用。
-
t-esc指令的作用t-esc指令专门用于将表达式的值安全地渲染到HTML输出中。它会自动对特殊字符（如<、>、&等）进行HTML实体编码，从而有效防止跨站脚本（XSS）攻击。这是在QWeb中显示任何动态内容的推荐方法。
<span t-esc="int(doc.total_mesin_jalan)"/>
当QWeb引擎处理到这行代码时，它会计算int(doc.total_mesin_jalan)的值，然后将结果（例如123）安全地插入到<span>标签的内部。
正确的解决方案
要将浮点数转换为整数并在QWeb中正确显示，应使用t-esc指令。以下是修正后的代码示例：
<tr class="border-black">
<td>
<strong>Total Mesin Jalan</strong>
</td>
<td class="text-right">
<span t-esc="int(doc.total_mesin_jalan)"/> %%
</td>
</tr>
<tr class="border-black">
<td>
<strong>Presentasi Total</strong>
</td>
<td class="text-right" style="background-color: #3498DB; color: #fff !important;">
<span t-esc="int(doc.presentasi_total)"/> %%
</td>
</tr>通过将t-value替换为t-esc，int(doc.total_mesin_jalan)的计算结果将直接作为<span>标签的文本内容被渲染出来。
注意事项与最佳实践
- 数据类型转换： QWeb模板支持Python的内置函数，因此可以直接使用int()、str()、float()等进行类型转换。
- 安全性： 始终优先使用t-esc来显示动态内容。如果需要渲染包含HTML标签的字符串（例如富文本字段），并且您完全信任其内容来源，可以使用t-raw指令。但t-raw不会进行HTML实体编码，因此存在XSS风险，应谨慎使用。
- 代码可读性： 保持模板代码的清晰和简洁。如果转换逻辑复杂，可以考虑在Python模型层进行预处理，将处理后的数据传递给QWeb模板，以提高模板的可读性和维护性。
总结
在Odoo QWeb开发中，正确区分和使用t-value与t-esc指令至关重要。当需要将计算或转换后的值显示在HTML元素内部时，务必使用t-esc指令，它不仅能确保内容正确渲染，还能提供必要的安全防护。而t-value则保留给变量赋值或属性设置的场景。遵循这些原则，可以构建出功能完善且安全的QWeb模板。
