docx-tables

创建可在任何地方正常使用的Word文档表格——Word、Google Docs等。

⚠️ 5条关键规则

1. 双重宽度设置（最关键）

在两个位置设置宽度——表格本身和每个单元格：

javascript
// 表格级别
new Table({
width: { size: 9360, type: WidthType.DXA },
columnWidths: [1872, 7488],
rows: [...]
})

// 单元格级别——每个单元格都需要宽度！
new TableCell({
width: { size: 1872, type: WidthType.DXA },
children: [...]
})

2. 仅使用DXA，绝不使用百分比

百分比在Google Docs中会出错。请使用DXA：

• - 1英寸 = 1440 DXA
• 带1英寸页边距的US Letter纸张 = 9360 DXA

javascript
// ❌ 错误
width: { size: 100, type: WidthType.PERCENTAGE }

// ✅ 正确
width: { size: 9360, type: WidthType.DXA }

3. 使用ShadingType.CLEAR

javascript
const { ShadingType } = require(docx);

// ❌ 错误——黑色背景！
shading: { type: ShadingType.SOLID, fill: E0F2F1 }

// ✅ 正确
shading: { type: ShadingType.CLEAR, fill: E0F2F1 }

4. 添加单元格内边距

javascript
const cellMargins = { top: 80, bottom: 80, left: 120, right: 120 };

new TableCell({
margins: cellMargins,
children: [...]
})

5. 列宽必须精确求和

对于1英寸页边距：9360 DXA

javascript
columnWidths: [1872, 7488] // = 9360 ✓
columnWidths: [3120, 3120, 3120] // = 9360 ✓

完整工作示例

javascript
const { Document, Packer, Paragraph, TextRun, Table, TableRow, TableCell,
WidthType, AlignmentType, BorderStyle, TableLayoutType, ShadingType } = require(docx);
const fs = require(fs);

const TOTAL_WIDTH = 9360;
const COL1 = 1872;
const COL2 = 7488;

const cellBorders = {
top: { style: BorderStyle.SINGLE, size: 1, color: CCCCCC },
bottom: { style: BorderStyle.SINGLE, size: 1, color: CCCCCC },
left: { style: BorderStyle.SINGLE, size: 1, color: CCCCCC },
right: { style: BorderStyle.SINGLE, size: 1, color: CCCCCC }
};

const cellMargins = { top: 80, bottom: 80, left: 120, right: 120 };

const doc = new Document({
sections: [{
properties: {
page: { margin: { top: 1440, right: 1440, bottom: 1440, left: 1440 } }
},
children: [
new Table({
layout: TableLayoutType.FIXED,
width: { size: TOTAL_WIDTH, type: WidthType.DXA },
columnWidths: [COL1, COL2],
rows: [
new TableRow({
children: [
new TableCell({
children: [new Paragraph({
children: [new TextRun({ text: Header, bold: true, color: FFFFFF })],
alignment: AlignmentType.CENTER
})],
width: { size: TOTAL_WIDTH, type: WidthType.DXA },
columnSpan: 2,
shading: { type: ShadingType.CLEAR, fill: 1565C0 },
borders: cellBorders,
margins: cellMargins
})
]
}),
new TableRow({
children: [
new TableCell({
children: [new Paragraph(Col 1)],
width: { size: COL1, type: WidthType.DXA },
borders: cellBorders,
margins: cellMargins
}),
new TableCell({
children: [new Paragraph(Col 2)],
width: { size: COL2, type: WidthType.DXA },
borders: cellBorders,
margins: cellMargins
})
]
})
]
})
]
}]
});

Packer.toBuffer(doc).then(buffer => {
fs.writeFileSync(output.docx, buffer);
});

列宽速查表

对于带1英寸页边距的US Letter纸张 = 9360 DXA：

故障排除

Google Docs中表格变窄？

• - 使用WidthType.DXA，而非PERCENTAGE
• 为每个TableCell添加width

单元格背景变黑？

• - 使用ShadingType.CLEAR，而非SOLID

文字紧贴边框？

• - 添加margins: { top: 80, bottom: 80, left: 120, right: 120 }

列宽不均匀？

• - 确认列宽总和精确等于9360