# ERPNext Jinja 模板语法技巧 > 修正 ERPNext/Frappe v14/v15/v16 中打印格式、电子邮件模板和门户页面的 Jinja 语法。 ** ** ## 何时使用此技能在以下情况下使用此技能： * 创建或修改打印格式 * 开发电子邮件模板 * 构建门户页面 (www/*.html) * 通过钩子添加自定义 Jinja 过滤器/方法请勿用于： * 报告打印格式（它们使用 JavaScript 模板，而不是 Jinja） * 客户端脚本（使用 erpnext-syntax-clientscripts） * 服务器脚本（使用 erpnext-syntax-serverscripts） ** ** ## 每个模板类型的上下文对象 ### 打印格式对象|描述 ---|--- `文档` |正在打印的文档 `冰沙` |带有实用方法的 Frappe 模块 `_()` |翻译功能 ### 电子邮件模板对象|描述 ---|--- `文档` |链接的文档 `冰沙` |冰沙模块（有限） ### 门户页面对象|描述 ---|--- `frappe.session.user` |当前用户 `frappe.form_dict` |查询参数 `frappe.lang` |当前语言自定义上下文 |通过Python控制器 > **请参阅**：`references/context-objects.md` 了解完整的详细信息。 ** ** ## 基本方法 ### 格式化（始终使用） {# 推荐用于打印格式的字段#} {{ doc.get_formatted("posting_date") }} {{ doc.get_formatted("grand_total") }} {# 对于子表行 - 传递父文档 #} {% for row in doc.items %} {{ row.get_formatted("rate", doc) }} {{ row.get_formatted("金额", doc) }} {% 结束 %} {# 一般格式#} {{ frappe.format(value, {'fieldtype': '货币'}) }} {{ frappe.format_date(doc.posting_date) }} ### 文档检索 {# 完整文档#} {% set customer = frappe.get_doc("客户", doc.customer) %} {# 具体字段值（更高效）#} {% set abbr = frappe.db.get_value("公司", doc.company, "abbr") %} {# 记录列表#} {% 设置任务 = frappe.get_all('任务', filters={'status': '打开'}, 字段=['标题','到期日期']) %} ### 翻译（面向用户的字符串需要）

{{ _("总计：{0}").format(doc.grand_total) }}

> **参见**：`references/methods-reference.md` 了解所有方法。 ** ** ## 控制结构 ### 条件 {% if doc.status == "已付费" %} {{ _("已付费") }} {% elif doc.status == "逾期" %} {{ _("逾期") }} {%其他%} {{ doc.status }} {% 结束 %} ### 循环 {% for item in doc.items %} {{ 循环索引 }} {{ item.item_name }} {{ item.get_formatted("金额", doc) }} {%其他%} {{ _("没有项目") }} {% 结束 %} ### 循环变量变量|描述 ---|--- `循环索引` | 1-索引位置 `循环.first` |首先正确 `loop.last` |最后是真的 `循环长度` |总项目 ### 变量 {% 设置总计 = 0 %} {% set customer_name = doc.customer_name | % set customer_name = doc.customer_name |默认（'未知'）%} ** ** ## 过滤器 ### 常用过滤|示例 ---|--- `默认` | `{{ 值 |默认('不适用') }}` `长度` | `{{ 项目 |长度 }}` `加入` | `{{ 名称 |加入(', ') }}` `截断` | `{{ 文本 |截断(100) }}` `安全` | ``{{ html |安全 }}` （仅受信任的内容！） > **参见**：`references/filters-reference.md` 了解所有过滤器。 ** ** ## 打印格式模板 <风格> .header { 背景：#f5f5f5;内边距：15px； } .table { 宽度：100%；边界崩溃：崩溃； } .table th, .table td { 边框：1px 实心 #ddd;内边距：8px； } .text-right { 文本对齐：右； }

{{ _("日期") }}: {{ doc.get_formatted("posting_date") }}

<表类=“表”> <标题> {{ _("项目") }} {{ _("数量") }} {{ _("金额") }} <正文> {% for row in doc.items %} {{ row.item_name }} {{ row.qty }} {{ row.get_formatted("金额", doc) }} {% 结束 %}

{{ _("总计") }}: {{ doc.get_formatted("grand_total") }}

** ** ## 电子邮件模板

{{ _("亲爱的") }} {{ doc.customer_name }},

{{ _("发票") }} {{ doc.name }} {{ _("for") }} {{ doc.get_formatted("grand_total") }} {{ _("到期了。") }}

{{ _("截止日期") }}: {{ frappe.format_date(doc.due_date) }}

{% if doc.items %}

{{ item.item_name }} - {{ item.qty }} x {{ item.get_formatted("rate", doc) }}

{% 结束 %}

{{ _("最诚挚的问候") }},
{{ frappe.db.get_value("公司", doc.company, "company_name") }}

** ** ## 带控制器的门户页面 ### www/projects/index.html {% 扩展“templates/web.html” %} {% 块标题 %}{{ _("项目") }}{% endblock %} {% 阻止 page_content %}

{% if frappe.session.user != 'Guest' %}

{{ _("欢迎") }}, {{ frappe.get_fullname() }}

{% 结束 %} {% 项目中的项目 %}

{%其他%}

{% 结束 %} {% 末端嵌段 %} ### www/projects/index.py 进口冰沙 def get_context(上下文): context.title = "项目" context.projects = frappe.get_all( “项目”，过滤器={“is_public”：1}， fields=[“名称”,“标题”,“描述”], order_by="创建描述" ）返回上下文 ** ** ## 通过 jenv Hook 自定义过滤器/方法 ### 钩子.py jenv = { "methods": ["myapp.jinja.methods"], “过滤器”：[“myapp.jinja.filters”] } ### myapp/jinja/methods.py 进口冰沙 def get_company_logo(公司): """获取公司徽标 URL""" 返回 frappe.db.get_value("公司", 公司, "company_logo") 或 "" ### 用法

** ** ## 关键规则 ### ✅ 永远 1. 对所有面向用户的字符串使用 `_()` 2. 对货币/日期字段使用 get_formatted() 3. 使用默认值：`{{ value |默认('') }}` 4. 子表行：`row.get_formatted("field", doc)` ### ❌从不 1.循环执行查询（N+1问题） 2. 使用`|用户输入安全（XSS 风险） 3. 模板中的大量计算（用Python做） 4. 报表打印格式中的 Jinja 语法（他们使用 JS） ** ** ## 报告打印格式（不是 Jinja！） **警告**：查询/脚本报告的报告打印格式使用 JavaScript 模板。方面| Jinja（打印格式）| JS（报告打印格式） ---|---|--- 输出| `{{ }}` | `{%=%}` 代码| `{% %}` | `{%%}` 语言 |蟒蛇 | JavaScript {% for(var i=0; i{%= data[i].name %} {% } %} ** ** ## 版本兼容性特色 | v14 | v15 ---|---|--- 基本 Jinja API | ✅ | ✅ 获取格式化（）| ✅ | ✅ jenv 钩子 | ✅ | ✅ 门户页面 | ✅ | ✅ frappe.utils.format_date 格式为 | ✅ | ✅+ ** ** ## V16：Chrome PDF 渲染 **版本 16 引入了基于 Chrome 的 PDF 渲染**，取代了 wkhtmltopdf。 ### 主要差异方面| v14/v15 (wkhtmltopdf) | v16（铬） ---|---|--- CSS 支持 | CSS3 有限 |完整的现代CSS 弹性盒/网格 |部分|全力支持分页符| `分页符-*` |首选“break-*” 字体|系统字体|支持网络字体性能|更快 |稍微慢一点 ### V16 的 CSS 更新 /* v14/v15 */ .page-break { page-break-before: 总是; } /* v16 - 两者都可以，但优先使用break-* */ .page-break { 中断前：页面； } ### 配置（V16） # 在 site_config.json 中 { "pdf_engine": "chrome", # 或 "wkhtmltopdf" 旧版本 “chrome_path”：“/usr/bin/chromium” } ### 打印格式兼容性大多数打印格式均保持不变。如果使用更新： * 复杂的CSS布局（现在完全支持flexbox/grid） * 自定义字体（网络字体现在可以使用） * 高级分页控制 ** ** ## 参考文件文件|内容 ---|--- `references/context-objects.md` |每个模板类型的可用对象 `references/methods-reference.md` |所有 frappe.* 方法 `references/filters-reference.md` |标准和定制过滤器 `references/examples.md` |完整的工作示例 `references/anti-patterns.md` |要避免的错误 ** ** ## 另请参阅 * `erpnext-syntax-hooks` \- 用于 hooks.py 中的 jenv 配置 * `erpnext-impl-jinja` \- 用于实现模式 * `erpnext-errors-jinja` \- 用于错误处理

{{ _("发票") }}

{{ doc.select_print_heading 或 _("发票") }}

{{ _("项目") }}

{{ 项目.标题 }}

Erpnext 语法 Jinja

包含技能