如何使用 docxtpl 根据条件设置 Word 表格整行背景色?
可以先在 Python 中根据条件计算每条记录的背景色,再在 Word 模板的数据行中为每个单元格添加 {% cellbg row.bg %}。同一行的单元格使用相同颜色,就能实现整行背景色。
cellbg 用于单元格,需要放在单元格内容的最开头。颜色使用不带 # 的十六进制字符串,例如 FFC7CE。具体用法见 docxtpl 官方文档。
1. 在 Python 中准备颜色和数据
以下示例假设表格有两列,row[0] 是检查项,row[1] 是状态。原问题没有明确状态所在的列,如果实际结构不同,需要调整判断位置。
可以先在 Python 中取出 Summary,构造供模板使用的 summary_rows,以简化模板:
from docxtpl import DocxTemplate
# 示例数据;接入现有程序时,将此处替换为 tables = img.tables
# 每条记录依次为:检查项、状态
tables = {
"Summary": [
["Check A", "OK"],
["Check B", "Error"],
["Check C", "Fail"],
]
}
summary_rows = []
for values in tables.get("Summary", []):
status = str(values[1]).strip()
summary_rows.append({
"cells": values,
"bg": "FFC7CE" if status in {"Error", "Fail"} else "FFFFFF",
})
doc = DocxTemplate("template.docx")
doc.render({"summary_rows": summary_rows}, autoescape=True)
doc.save("report.docx")
代码中的 tables = { 应顶格书写。异常状态使用浅红色 FFC7CE,其余状态显式设置为白色 FFFFFF。判断区分大小写;如果数据可能包含 ERROR 等写法,可以先统一大小写。
autoescape=True 用于处理普通文本中的 <、>、& 等 XML 特殊字符,详见官方转义说明。
2. 在 Word 中建立真正的表格
在 template.docx 中插入一个两列表格,按下面的布局填写。示意表的每一行都对应 Word 中的一个实际表格行:
| 第一列 | 第二列 |
|---|---|
| 检查项 | 状态 |
{%tr for row in summary_rows %} | 留空 |
{% cellbg row.bg %}{{ row.cells[0] }} | {% cellbg row.bg %}{{ row.cells[1] }} |
{%tr endfor %} | 留空 |
“留空”表示对应单元格不填写内容,不要将这两个字输入模板。
循环的开始行和结束行只用于控制结构,渲染时会被移除;中间的数据行会随记录重复。{%tr ... %} 的结构处理规则可参见官方标签说明。
如果表格还有其他列,也要在这些列的数据单元格开头添加相同的 {% cellbg row.bg %},否则只有添加标签的单元格会改变底色。
3. 调整现有循环布局
原片段将 {%tr for row in rows%}、数据占位符和 {%tr endfor %} 连写在一起,仅凭文字无法确定它们在 Word 中的实际位置。需要检查两点:
- 开始标签和结束标签分别放在独立的表格行中。
- 数据占位符放在两者之间的数据行中,不要放在控制行内。
同一个实际表格行不能同时包含两个 {%tr ... %} 标签。控制标签所在行会被删除,数据放在控制行里也会丢失。
示例已在 Python 中筛选 Summary,因此模板不需要再保留外层的 img.tables.items() 循环和 key == "Summary" 判断。
4. 颜色未生效时检查什么
先检查 {% cellbg row.bg %} 是否位于每个数据单元格的开头,前面不要放空格、空段落或其他文字。再确认 row.bg 的值是 FFC7CE 这样不带 # 的颜色值。
示例中的 FFFFFF 会把正常行设为白色。如果需要保留模板原有的隔行底色,需要按实际配色要求调整默认值。包含合并单元格的复杂表格,也应使用真实模板检查最终显示效果。
备注:内容仅供参考。
