本文旨在解决odoo qweb报表或视图中将浮点数转换为整数后无法正确显示的问题。核心在于理解qweb指令`t-value`和`t-esc`的区别。通过使用`t-esc`指令结合python内置的`int()`函数，开发者可以确保转换后的整数值被正确渲染并显示在odoo模板中，避免只显示占位符或空值的情况。
在Odoo的QWeb模板系统中，我们经常需要处理各种数据类型，并在报表或视图中以特定格式展示。其中，将浮点数（float）转换为整数（int）是一个常见的需求，例如，当我们需要显示一个百分比的整数部分，或者某个数量不应包含小数时。然而，开发者在尝试进行这种转换并显示结果时，可能会遇到值未能正确渲染的问题。
常见的误区：使用 t-value 尝试显示转换后的整数
许多开发者在初次尝试将浮点数转换为整数并显示时，可能会直观地选择使用t-value指令。例如，他们可能会编写类似以下的代码片段：
<tr class="border-black">
<td>
<strong>Total Mesin Jalan</strong>
</td>
<td class="text-right">
<span t-value="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-value="int(doc.presentasi_total)"/> %%
</td>
</tr>尽管int(doc.total_mesin_jalan)确实执行了浮点数到整数的转换，但使用t-value指令来尝试直接显示这个结果是无效的。t-value指令主要用于在QWeb内部设置变量值、传递数据给其他指令或组件，或者在特定HTML属性中设置值，它并不会将内容直接渲染为HTML文本节点。因此，上述代码在Odoo报表中运行时，会发现<span>标签内并没有显示转换后的整数，可能只显示了%%符号或留白。
正确的做法：利用 t-esc 指令显示转换后的整数
要在QWeb模板中正确显示任何动态计算或转换后的值，我们应该使用t-esc指令。t-esc指令专门用于将表达式的结果输出为HTML文本，并且会自动对输出内容进行HTML转义，以防止跨站脚本（XSS）攻击。
将上述代码中的t-value替换为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-esc="int(doc.total_mesin_jalan)"，QWeb引擎会首先执行int()函数将doc.total_mesin_jalan（浮点数）转换为整数，然后将这个整数值作为文本内容插入到<span>标签内部，从而在报表中正确显示。
t-value 与 t-esc 的核心区别
理解这两个指令的根本差异对于编写高效且安全的QWeb模板至关重要：
-
t-value:
- 用途: 主要用于在QWeb内部赋值、设置属性值、或作为条件判断的一部分。
- 行为: 不会直接在DOM中生成可见的文本内容。它更像是一个内部处理指令。
- 示例: <t t-set="my_var" t-value="1 + 2"/> (设置变量); <div t-att-data-id="record.id"/> (设置属性)。
-
t-esc:
- 用途: 专门用于将表达式的结果作为HTML文本内容输出到模板中。
- 行为: 会自动对输出内容进行HTML转义，以确保安全性，防止恶意脚本注入。
- 示例: <p>Hello, <span t-esc="user.name"/>!</p> (显示用户名)。
注意事项与最佳实践
- 数据类型验证: 在应用int()函数之前，请确保doc.total_mesin_jalan确实是一个可以转换为整数的数值类型（浮点数或字符串数字）。如果传入非数值类型，可能会导致运行时错误。
- 四舍五入行为: Python的int()函数在将浮点数转换为整数时，会直接截断小数部分（向下取整，例如int(3.9)结果是3，int(-3.9)结果是-3）。如果需要进行标准的四舍五入，应先使用round()函数，例如t-esc="int(round(doc.total_mesin_jalan))"。
- 安全性: t-esc的自动转义功能是其一大优势。它能有效防止用户输入数据中的恶意HTML或JavaScript代码被直接渲染，从而增强应用的安全性。
- 清晰的语义: 始终根据你的意图选择正确的指令。需要显示内容时用t-esc，需要内部处理或赋值时用t-value。
总结
在Odoo QWeb模板中，将浮点数转换为整数并正确显示的关键在于选用正确的QWeb指令。务必使用t-esc来输出动态值，并结合Python的int()函数进行类型转换。理解t-value和t-esc之间的根本差异，不仅能解决显示问题，还能帮助你编写出更健壮、更安全的Odoo定制化代码。遵循这些最佳实践，可以确保你的Odoo报表和视图能够准确无误地展示所需的数据。
