使用 python-docx 在表格中指定边框外观

Question

我正在阅读python-docx的教程和文档。

但是，我找不到任何关于如何指定和操作在 Microsoft Word 文档中创建的表格的边框外观的参考。

当我使用以下代码时：

from docx import Document
from docx.shared import Inches

document = Document()

################################
################################
################################

table = document.add_table(rows=1, cols=3)
hdr_cells = table.rows[0].cells
hdr_cells[0].text = 'Qty'
hdr_cells[1].text = 'Id'
hdr_cells[2].text = 'Desc'

row_cells = table.add_row().cells
row_cells[0].text = 'Str0'
row_cells[1].text = 'Str1'
row_cells[2].text = 'Str2'

row2_cells = table.add_row().cells
row2_cells[0].text = 'Str00'
row2_cells[1].text = 'Str11'
row2_cells[2].text = 'Str22'

################################
################################
################################

document.save('demo.docx')

生成的docx文件显示3x3带有标题的表格。目前这张桌子上没有黑色边框（内部或外部）。

如何指定标题周围的上下边框、环绕表格的下边框以及内部垂直边框？

例如：

Answer 1

不幸的是，没有办法直接从python-docx. 你基本上需要使用一个style，它指定了这些。该样式必须已存在于 Word 中。

为了生成您喜欢的表格样式，您需要在 Word 中手动创建一个新的空文档，自定义其中一种现有表格样式（例如Colorful Shading），并使用此修改后的样式添加表格。接下来，您删除此表并将文件（例如example.docx）保存在您的磁盘上。这是将修改后的样式保存在文档中所必需的。

您所要做的就是使用加载文件python-docx并添加一个新表，该表将引用（修改后的）表样式：

document = Document('example.docx')
table = document.add_table(rows=1, cols=3)
table.style = 'ColorfulShading'

有关Word 中样式如何工作的详细信息，另请参阅文档中的了解样式。

Answer 2

由于python-docx库目前没有直接设置单元格边框的函数方法，我从这个网站找到了这个解决方案（强烈推荐讲座）：

from docx.table import _Cell
from docx.oxml import OxmlElement
from docx.oxml.ns import qn

def set_cell_border(cell: _Cell, **kwargs):
    """
    Set cell`s border
    Usage:
    set_cell_border(
        cell,
        top={"sz": 12, "val": "single", "color": "#FF0000", "space": "0"},
        bottom={"sz": 12, "color": "#00FF00", "val": "single"},
        start={"sz": 24, "val": "dashed", "shadow": "true"},
        end={"sz": 12, "val": "dashed"},
    )
    """
    tc = cell._tc
    tcPr = tc.get_or_add_tcPr()

    # check for tag existnace, if none found, then create one
    tcBorders = tcPr.first_child_found_in("w:tcBorders")
    if tcBorders is None:
        tcBorders = OxmlElement('w:tcBorders')
        tcPr.append(tcBorders)
 
    # list over all available tags
    for edge in ('start', 'top', 'end', 'bottom', 'insideH', 'insideV'):
        edge_data = kwargs.get(edge)
        if edge_data:
            tag = 'w:{}'.format(edge)
 
            # check for tag existnace, if none found, then create one
            element = tcBorders.find(qn(tag))
            if element is None:
                element = OxmlElement(tag)
                tcBorders.append(element)
 
            # looks like order of attributes is important
            for key in ["sz", "val", "color", "space", "shadow"]:
                if key in edge_data:
                    element.set(qn('w:{}'.format(key)), str(edge_data[key]))

此处列出了用于编辑单元格边框的可选关键字参数的列表。