1.表格

1.1 添加表格

添加表格很简单，只需要调用一下add_table()即可，返回一个Table对象，参数可以指定行、列、样式

from docx import Document

doc = Document()
# 添加一个5行3列的表格，样式是网格实线
table = doc.add_table(5, 3, style="Table Grid")
doc.save('./test.docx')

1.2 添加行列

from docx import Document
from docx.shared import Cm, RGBColor, Pt
...
table.add_row()  # 在最下面添加一行
table.add_column(Pt(25))  # 在最右边添加一列并指定宽度为25磅

1.3 表格样式

...
table.cell(1, 2).text = "冰冷的希望"
table.style.font.size = Pt(15)  # 字体大小15磅
table.style.font.color.rgb = RGBColor.from_string("6495ED")  # 字体颜色
table.style.paragraph_format.alignment = WD_PARAGRAPH_ALIGNMENT.LEFT  # 左对齐

2.行列对象

首先是一个表格（Table），表格里有行（Row）和列（Column），行或列里有单元格（Cell）
python-docx中用_Row和_Column分别代表行和列，，用_Rows和_Columns表示多行多列，可以使用Table对象的rows和columns属性获取所有行列，如果想要访问行列里的单元格，可以进一步遍历

from docx import Document

doc = Document()
table = doc.add_table(5, 3, style="Table Grid")
print(table.rows)  # 获取所有行
print(table.columns)  # 获取所有列
# 按行遍历单元格
for row in table.rows:
    for cell in row.cells:
        print(cell)
# 按列遍历单元格
for col in table.columns:
    for cell in col.cells:
        print(cell)

_Rows和_Columns对象里有一个table属性可以返回所属的表格对象

doc = Document()
table = doc.add_table(5, 3, style="Table Grid")

for row in table.rows:
    print(row.table)

for col in table.columns:
    print(col.table)

通过上面的遍历可以发现其实_Rows和_Columns就是分别包含Row和Column的可迭代对象，可以通过遍历分别取出Row和Column对象，而Row和Column对象也很简单，两者的属性一样的，如下

for row in table.rows:
    print(row.cells)  # 所有单元格
    print(row.height)  # 高度
    # 第2行高度改为30磅
    if row._index == 2:
        row.height = Pt(30)
    print(row.height_rule)  # 指定高度的规则
    print(row.table)  # 当前表格对象
    print(row._index)  # 下标

3.单元格对象

3.1 获取Cell对象

python-docx中用Cell代表单元格，获取单元格对象的方式除了上面的嵌套循环，还可以通过下标获取

doc = Document()
table = doc.add_table(5, 3, style="Table Grid")

# 获取第1行第3列的单元格（下标从0开始）
cell1 = table.cell(0, 2)

3.2 修改单元格文本

如果想要修改单元格的文本，可以直接修改Cell对象的text属性，其实它也是获取单元格的段落然后修改，所以有两种方式

from docx import Document

doc = Document()
table = doc.add_table(5, 3, style="Table Grid")

# 获取第1行第3列的单元格（下标从0开始）
cell1 = table.cell(0, 2)
cell1.text = "冰冷的希望"

cell2 = table.cell(1, 2)
paragraph= cell2.paragraphs[0]
run = paragraph.add_run("冰冰很帅")

3.3 合并单元格

...
cell3 = table.cell(2, 1)
cell4 = table.cell(3, 2)
cell3.merge(cell4)

3.4 单元格样式

可以设置整个表格的样式，也可以单独设置单元格的样式，优先显示单元格样式

from docx import Document
from docx.enum.text import WD_PARAGRAPH_ALIGNMENT
from docx.shared import Cm, RGBColor, Pt

...

cell2 = table.cell(1, 2)
paragraph = cell2.paragraphs[0]
run = paragraph.add_run("冰冰很帅")

# 设置单元格样式
run.font.color.rgb = RGBColor.from_string("00FFFF")  # 字体颜色
run.font.size = Cm(1)  # 字体大小,1厘米
paragraph.paragraph_format.alignment = WD_PARAGRAPH_ALIGNMENT.CENTER  # 居中对齐

# 设置表格样式，但单元格样式优先显示
table.style.font.size = Pt(15)  # 字体大小15磅
table.style.font.color.rgb = RGBColor.from_string("6495ED")  # 字体颜色
table.style.paragraph_format.alignment = WD_PARAGRAPH_ALIGNMENT.LEFT  # 左对齐

3.5 宽高度

...
# 以同一行或同一列的最大值为准
table.cell(0, 0).width = Cm(3)
table.rows[0].height = Cm(2)

需求 实现下面的表格效果

 代码：

//利用去重原理
			function table(dom) {
				var arr = [];
				var f= document.getElementsByClassName(dom);
				for (let i = 0; i < f.length; i++) {

					if (arr.indexOf(f[i].innerHTML) == -1) {
						arr.push(f[i].innerHTML);
						var index = i; //index是第一个元素
						document.getElementsByClassName(dom)[i].style.borderBottom = 0 + "px";
					} else {
						document.getElementsByClassName(dom)[i].style.display = "none"; //隐藏重复的元素
						document.getElementsByClassName(dom)[index].rowSpan += 1; //删去重复的元素,就给第一个元素的rowspan+1
					}
				}
			}
			table('f1')
			table('f2')

 想合并哪些单元格 直接给他添加对应类名即可

	<table class="table table-striped table-sm table1">
								<thead>
									<tr>
										<th colspan="3">一级
											指标</th>
										<th>二级
											指标</th>
										<th>三级指标</th>
										<th>指标说明</th>
									</tr>
								</thead>
								<tbody>
									<tr class="order">
										<td class="f1" colspan="3">111</td>
										<td>222</td>
										<td>333</td>
										<td>444</td>


									</tr>
									<tr class="order">
										<td class="f1" colspan="3">111</td>
										<td class="f2">222</td>
										<td>555</td>
										<td>666</td>

									</tr>
									<tr class="order">
										<td class="f1" colspan="3">111</td>
										<td class="f2">222</td>
										<td>777</td>
										<td>888</td>

									</tr>
									
								</tbody>
							</table>

前言

由于 Markdown 语法不支持合并单元格，所以考虑用 HTML 语法来实现。而 LogSeq 刚好对 HTML 语法提供了简化的 Hiccup 的语法支持，故用 Hiccup 语法实现合并单元格的效果。

实现

目标效果：

实现代码：

[:table 
	[:tr [:th {:rowspan 2}  "锁状态" ] [:th {:colspan 2} "25bit"] [:th {:rowspan 2} "4bit"] [:th "1bit"] [:th "2bit"]]
	[:tr [:th "23bit"] [:th "2bit"] [:th "是否偏向锁"] [:th "锁标志位"]]
	[:tr [:td "无锁状态"] [:td {:colspan 4} "对象 hashcod、对象分代年龄"] [:td "01"]]
	[:tr [:td "轻量级锁"] [:td {:colspan 4} "指向锁记录的指针"] [:td "00"]]
	[:tr [:td "重量级锁"] [:td {:colspan 4} "指向重量级锁的指针"] [:td "10"]]
	[:tr [:td "GC 标记"] [:td {:colspan 4} "空，不需要记录信息"] [:td "11"]]
	[:tr [:td "偏向锁"] [:td "线程 ID"] [:td "Epoch"] [:td "对象分代年龄"] [:td "1"] [:td "01"]]
]

这里的合并单元格主要通过 HTML <th>, <td> 标签的 colspan 和 rowspan 属性来完成，转换成 Hiccup 语法可参考Hiccup Lightning Tutorial

实现效果：