PAYATHON 2026

如何使用 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 会把正常行设为白色。如果需要保留模板原有的隔行底色,需要按实际配色要求调整默认值。包含合并单元格的复杂表格,也应使用真实模板检查最终显示效果。

备注:内容仅供参考。