Программное формирование таблиц в Word: библиотека python-docx

Пример 1. Создание таблицы с цветной шапкой, объединёнными ячейками и границами

В данном примере формируется таблица 4x3, первая строка используется как заголовок с заливкой и объединением двух последних столбцов. Для заливки используется OxmlElement с установкой цвета.

from docx import Document
from docx.shared import Inches, RGBColor
from docx.oxml.ns import qn, nsdecls
from docx.oxml import parse_xml, OxmlElement

doc = Document()
table = doc.add_table(4, 3, style='Table Grid')

# Объединение ячеек в первой строке: объединяем 1 и 2 столбец (0 и 1)
cell0 = table.cell(0, 0)
cell1 = table.cell(0, 1)
merged = cell0.merge(cell1)
merged.text = "Объединённый заголовок"

# Заливка первой строки (все ячейки в строке имеют один фон)
for cell in table.rows[0].cells:
    shading_elm = parse_xml(f'')
    cell._tc.get_or_add_tcPr().append(shading_elm)

# Заполнение остальных ячеек
for i in range(1, 4):
    for j in range(3):
        table.cell(i, j).text = f"{i},{j}"

# Установка ширины столбцов
table.columns[0].width = Inches(1.5)
table.columns[1].width = Inches(2)
table.columns[2].width = Inches(2)

doc.save('advanced_table.docx')

Результат: документ с таблицей, у которой первая строка (заголовок) имеет синий фон и объединённые первые две ячейки, остальные строки содержат координаты. Ширина столбцов установлена в дюймах.

Пример 2. Таблица с данными из CSV, форматированием чисел и выравниванием

Предположим, имеется CSV-файл с числовыми данными. Загружаем его в pandas, создаём таблицу, форматируем числа с двумя знаками после запятой и выравниваем столбцы по центру.

import pandas as pd
from docx import Document
from docx.shared import Pt
from docx.enum.text import WD_ALIGN_PARAGRAPH

df = pd.read_csv('data.csv')  # предположим, столбцы: Name, Value, Score
doc = Document()
rows = len(df) + 1
cols = len(df.columns)
table = doc.add_table(rows, cols, style='Light Grid Accent 1')

# Заголовки
for j, col in enumerate(df.columns):
    cell = table.cell(0, j)
    cell.text = col
    run = cell.paragraphs[0].runs[0]
    run.bold = True
    run.font.size = Pt(11)
    cell.paragraphs[0].alignment = WD_ALIGN_PARAGRAPH.CENTER

# Данные
for i, row in df.iterrows():
    for j, val in enumerate(row):
        cell = table.cell(i + 1, j)
        if isinstance(val, (int, float)):
            cell.text = f"{val:.2f}"
        else:
            cell.text = str(val)
        cell.paragraphs[0].alignment = WD_ALIGN_PARAGRAPH.CENTER

doc.save('formatted_from_csv.docx')

Результат: таблица с отформатированными заголовками (жирный, по центру) и выровненными по центру числовыми значениями с двумя десятичными знаками.

Пример 3. Настройка индивидуальных границ ячеек (пунктирные линии, толщина)

Этот пример демонстрирует, как задать разные стили границ для разных сторон таблицы через XML. Создаётся таблица 2x2, верхняя граница делается толстой красной, левая – пунктирной синей, остальные – обычными.

from docx import Document
from docx.oxml.ns import qn, nsdecls
from docx.oxml import OxmlElement

doc = Document()
table = doc.add_table(2, 2)

# Создаём элемент границ в свойствах таблицы
tbl_pr = table._tbl.tblPr
if tbl_pr is None:
    tbl_pr = OxmlElement('w:tblPr')
    table._tbl.insert(0, tbl_pr)

borders = OxmlElement('w:tblBorders')

# Верхняя граница (толстая, красная)
top = OxmlElement('w:top')
top.set(qn('w:val'), 'single')
top.set(qn('w:sz'), '24')  # 24 восьмых точки = 3pt
top.set(qn('w:color'), 'FF0000')
borders.append(top)

# Левая граница (пунктир, синий)
left = OxmlElement('w:left')
left.set(qn('w:val'), 'dashed')
left.set(qn('w:sz'), '8')
left.set(qn('w:color'), '0000FF')
borders.append(left)

# Остальные границы – по умолчанию (сплошная, 0.5pt, чёрная)
for name in ['bottom', 'right', 'insideH', 'insideV']:
    el = OxmlElement(f'w:{name}')
    el.set(qn('w:val'), 'single')
    el.set(qn('w:sz'), '4')
    el.set(qn('w:color'), '000000')
    borders.append(el)

tbl_pr.append(borders)

table.cell(0,0).text = "A"
table.cell(0,1).text = "B"
table.cell(1,0).text = "C"
table.cell(1,1).text = "D"

doc.save('custom_borders.docx')

Результат: таблица с нестандартными границами – верхняя толстая красная, левая пунктирная синяя, остальные стандартные.