DOCX
页面布局
配置页面尺寸、方向、页边距、分栏和分节符
通过 Section 属性控制文档布局。每个文档可以有多个具有不同布局的节。
页面尺寸和方向
{
"sections": [
{
"properties": {
"page": {
"size": { "width": 11906, "height": 16838, "orientation": "portrait" },
"margin": {
"top": 1440,
"bottom": 1440,
"left": 1440,
"right": 1440
}
}
},
"children": [{ "paragraph": { "children": ["Portrait page"] } }]
},
{
"properties": {
"page": {
"size": { "width": 16838, "height": 11906, "orientation": "landscape" }
}
},
"children": [{ "paragraph": { "children": ["Landscape page"] } }]
}
]
}
import { generateDocument } from "@office-open/docx";
const buffer = await generateDocument({
sections: [
// 纵向 A4
{
properties: {
page: {
size: { width: 11906, height: 16838, orientation: "portrait" },
margin: {
top: 1440,
bottom: 1440,
left: 1440,
right: 1440,
},
},
},
children: [{ paragraph: { children: ["Portrait page"] } }],
},
// 横向 A4
{
properties: {
page: {
size: { width: 16838, height: 11906, orientation: "landscape" },
},
},
children: [{ paragraph: { children: ["Landscape page"] } }],
},
],
});
页边距
{
"sections": [
{
"properties": {
"page": {
"margin": {
"top": 1440,
"bottom": 1440,
"left": 1440,
"right": 1440,
"gutter": 0,
"header": 720,
"footer": 720
}
}
},
"children": [{ "paragraph": { "children": ["Content with custom margins."] } }]
}
]
}
properties: {
page: {
margin: {
top: 1440, // 1 英寸（twip 单位）
bottom: 1440,
left: 1440,
right: 1440,
gutter: 0, // 装订线
header: 720, // 页眉距顶部距离
footer: 720, // 页脚距底部距离
},
},
},
分栏
创建多栏布局：
{
"sections": [
{
"properties": {
"page": {
"columns": { "count": 2, "space": 708 }
}
},
"children": [{ "paragraph": { "children": ["Two-column layout."] } }]
}
]
}
properties: {
page: {
columns: {
count: 2,
space: 708, // 栏间距（twip 单位）
},
},
},
分节符
控制节的过渡方式：
// 每个节可以指定其分隔类型
{
properties: {
type: "continuous", // 不分页
// type: "nextPage", // 默认 — 新页面
// type: "evenPage", // 下一偶数页
// type: "oddPage", // 下一奇数页
},
children: [...],
},
页面边框
{
"sections": [
{
"properties": {
"page": {
"borders": {
"top": { "style": "single", "size": 6, "color": "000000", "space": 24 },
"bottom": { "style": "single", "size": 6, "color": "000000", "space": 24 },
"left": { "style": "single", "size": 6, "color": "000000", "space": 24 },
"right": { "style": "single", "size": 6, "color": "000000", "space": 24 }
}
}
},
"children": [{ "paragraph": { "children": ["Page with borders."] } }]
}
]
}
properties: {
page: {
borders: {
top: { style: "single", size: 6, color: "000000", space: 24 },
bottom: { style: "single", size: 6, color: "000000", space: 24 },
left: { style: "single", size: 6, color: "000000", space: 24 },
right: { style: "single", size: 6, color: "000000", space: 24 },
},
},
},