简报、通讯与说明书常把正文分成两栏或三栏:版面更紧凑,长文也更容易扫读。栏间加一条分割线,视觉边界更清楚。分节解决的是另一个问题——同一份文档里,不同部分需要不同的纸张、页边距、页眉页脚或分栏数。
本文用 Spire.Doc for JavaScript 在浏览器中完成三件事:为正文节设置多栏、显示栏间分割线、插入分节符并分别设置各节。整个过程基于 WebAssembly 在浏览器端进行,不需要安装 Office,也不依赖后端服务,文档始终留在用户的设备上。
本文介绍三个核心功能点:
节与栏的关系
分栏是“节”的属性,不是整篇文档的属性。一个节可以有自己的栏数、栏宽与栏间距,不同节可以采用不同的分栏方案。因此,先确定要改哪一节,再设置栏,顺序不能颠倒。
| 概念 | 对应对象 | 作用范围 |
|---|---|---|
| 节 | Section |
页面设置、页眉页脚、分栏 |
| 栏 | Section.Columns |
节内正文的排列方式 |
| 分节符 | SectionBreakType |
标记节的边界与起始方式 |
本文的示例文档 Newsletter.docx 共两节:第 1 节是刊头,第 2 节是正文。刊头保持单栏,三个示例都只修改正文节,所以代码里取的是 doc.Sections.get_Item(1)。
有关安装和项目配置,请参考 React 项目中集成 Spire.Doc for JavaScript。下面的示例假定 Spire.Doc 已安装、WebAssembly 模块已初始化。
为 Word 文档设置多栏排版
为 Word 文档设置多栏排版,先要确认目标节当前有几栏。新建文档的节默认只有一栏;把正文改成两栏,就是把该节的栏数设为 2。Section.Columns.Populate(count, spacing) 可以一次设定总栏数与栏间距,宽度由 Word 按可用页面宽度均分。
栏间距的单位是磅(point),一英寸等于 72 磅,36 磅即 0.5 英寸。示例使用 36 磅,与 Word 默认的栏间距一致。
具体操作步骤如下:
- 获取 Spire.Doc 的 WASM 模块,确认已就绪。
- 载入中文字体与
Newsletter.docx。 - 创建
Document对象并加载文档。 - 取出正文节,调用
Columns.Populate(2, 36)设为两栏。 - 保存结果,并从 VFS 读出文件触发浏览器下载。
为 Word 文档设置多栏排版的代码如下:
function App() {
const setColumns = async () => {
// 获取 Spire.Doc 的 WASM 模块
const docModule = window.wasmModule?.spiredoc;
if (!docModule) {
alert('Spire.Doc is not ready yet');
return;
}
// 载入示例文档
await window.spire.FetchFileToVFS('Newsletter.docx', '', `${process.env.PUBLIC_URL}/data/`);
const doc = new docModule.Document();
doc.LoadFromFile('Newsletter.docx');
// 第 1 节是刊头,第 2 节(索引 1)是正文
const section = doc.Sections.get_Item(1);
// 设为两栏,栏间距 36 磅(0.5 英寸)
section.Columns.Populate(2, 36);
const outputFileName = 'NewsletterTwoColumns.docx';
doc.SaveToFile({ fileName: outputFileName, fileFormat: docModule.FileFormat.Docx2013 });
doc.Dispose();
// 从 VFS 读取生成的文件,触发下载
const fileArray = window.dotnetRuntime.Module.FS.readFile(outputFileName);
const blob = new Blob([fileArray], {
type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
});
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = outputFileName;
a.click();
URL.revokeObjectURL(url);
};
return (
<div style={{ textAlign: 'center', height: '300px' }}>
<h1>设置分栏</h1>
<button onClick={setColumns}>生成</button>
</div>
);
}
export default App;
正文节设置为两栏后的通讯文档,刊头仍保持单栏:

Populate 与 AddColumn 有什么区别
Columns.Populate(count, spacing) 里的 count 是总栏数:设为 2 就是两栏,设为 3 就是三栏,重复调用不会继续累加。
Section.AddColumn(width, spacing) 则是追加一栏:从默认的一栏变成两栏调用一次,变成三栏调用两次。它接收新栏的宽度与间距,但不会自动缩小原来的第一栏。追加后建议再调用一次 MakeColumnsSameWidth(),让 Word 按页面宽度重新均分各栏:
// 从默认的一栏追加第二栏
section.AddColumn(240, 36);
// 各栏等宽,避免首栏仍按整页宽度计算
section.MakeColumnsSameWidth();
只设置栏数、不需要精确控制每栏宽度时,用 Populate 更直接;需要在现有栏数上继续追加时,再用 AddColumn。
栏宽与栏间距如何分配
可用正文宽度等于纸张宽度减去左右页边距。两栏等宽时,每栏宽度约为 (可用宽度 - 栏间距) / 2。如果各栏宽度之和超过可用宽度,Word 会压缩栏宽或把内容挤到下一栏,表现与预期不同。
Populate 与 MakeColumnsSameWidth() 都会按可用宽度均分各栏,一般不需要手算。只有在需要不等宽栏,或栏数较多、间距较窄时,才需要先按页边距估算,再逐个调整。
显示分栏之间的分割线
显示分栏之间的分割线,是把节级属性 PageSetup.ColumnsLineBetween 设为 true。开启后,该节所有栏之间都会出现一条竖线;关闭时栏间只有空白。分割线不会改变栏宽与栏间距,只影响视觉边界。
具体操作步骤如下:
- 获取 Spire.Doc 的 WASM 模块,确认已就绪。
- 载入中文字体与
Newsletter.docx。 - 创建
Document对象并加载文档。 - 取出正文节,设为两栏,再把
ColumnsLineBetween设为true。 - 保存结果,并从 VFS 读出文件触发浏览器下载。
显示分栏之间的分割线的代码如下:
function App() {
const showColumnLine = async () => {
// 获取 Spire.Doc 的 WASM 模块
const docModule = window.wasmModule?.spiredoc;
if (!docModule) {
alert('Spire.Doc is not ready yet');
return;
}
await window.spire.FetchFileToVFS('Newsletter.docx', '', `${process.env.PUBLIC_URL}/data/`);
const doc = new docModule.Document();
doc.LoadFromFile('Newsletter.docx');
const section = doc.Sections.get_Item(1);
// 先分栏,再打开栏间分割线
section.Columns.Populate(2, 36);
section.PageSetup.ColumnsLineBetween = true;
const outputFileName = 'NewsletterColumnLine.docx';
doc.SaveToFile({ fileName: outputFileName, fileFormat: docModule.FileFormat.Docx2013 });
doc.Dispose();
const fileArray = window.dotnetRuntime.Module.FS.readFile(outputFileName);
const blob = new Blob([fileArray], {
type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
});
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = outputFileName;
a.click();
URL.revokeObjectURL(url);
};
return (
<div style={{ textAlign: 'center', height: '300px' }}>
<h1>显示分栏分割线</h1>
<button onClick={showColumnLine}>生成</button>
</div>
);
}
export default App;
两栏之间出现一条竖直分割线:

分割线的高度由谁决定
分割线的高度取该页正文区域内内容较多的那一栏,而不是固定通栏到底。若某页只有一栏有内容,分割线通常只覆盖有内容的高度。栏间距越大,分割线与文字的距离越宽,这个距离由栏间距控制,与线宽无关。
如何关闭分割线
把 ColumnsLineBetween 设回 false 即可关闭,不需要删除节或重建栏:
section.PageSetup.ColumnsLineBetween = false;
若同一文档中只有部分节需要分割线,应逐节设置,而不是在文档级统一处理。新节默认继承前一节的页面设置,插入分节符后如果不需要分割线,记得在新节上显式关闭。
插入分节符并分别设置各节
插入分节符并分别设置各节,适合一份文档中出现“前一部分单栏、后一部分两栏”,或者“封面无页眉、正文有页眉”这类需求。分节符标记新节的开始,新节会继承前一节的页面设置,之后可以单独修改栏数、页边距与页眉页脚。
SectionBreakType 决定新节从何处开始:
| 取值 | 新节的起始位置 |
|---|---|
NewPage |
从新的一页开始 |
NewColumn |
从下一栏开始 |
EvenPage |
从下一个偶数页开始 |
Oddpage |
从下一个奇数页开始 |
NoBreak |
不分页,紧接当前内容 |
具体操作步骤如下:
- 获取 Spire.Doc 的 WASM 模块,确认已就绪。
- 载入中文字体与
Newsletter.docx,取出正文节。 - 遍历正文节段落,找到“深度报道”标题所在的位置。
- 在标题前一个段落上调用
InsertSectionBreak插入分节符。 - 取出新节,设为两栏并显示分割线,保存后下载。
插入分节符并分别设置各节的代码如下:
function App() {
const insertSectionBreak = async () => {
// 获取 Spire.Doc 的 WASM 模块
const docModule = window.wasmModule?.spiredoc;
if (!docModule) {
alert('Spire.Doc is not ready yet');
return;
}
await window.spire.FetchFileToVFS('Newsletter.docx', '', `${process.env.PUBLIC_URL}/data/`);
const doc = new docModule.Document();
doc.LoadFromFile('Newsletter.docx');
const section = doc.Sections.get_Item(1);
const paragraphs = section.Paragraphs;
// 找到“深度报道”标题所在段落
let markerIndex = -1;
for (let i = 0; i < paragraphs.Count; i++) {
const text = String(paragraphs.get_Item(i).Text || '');
if (text.includes('深度报道')) {
markerIndex = i;
break;
}
}
if (markerIndex <= 0) {
alert('未找到插入位置');
return;
}
// 在标题前一个段落上插入分节符,标题及其后内容进入新节
paragraphs.get_Item(markerIndex - 1).InsertSectionBreak(docModule.SectionBreakType.NoBreak);
// 新节:两栏 + 分割线
const newSection = doc.Sections.get_Item(2);
newSection.Columns.Populate(2, 36);
newSection.PageSetup.ColumnsLineBetween = true;
const outputFileName = 'NewsletterSectionBreak.docx';
doc.SaveToFile({ fileName: outputFileName, fileFormat: docModule.FileFormat.Docx2013 });
doc.Dispose();
const fileArray = window.dotnetRuntime.Module.FS.readFile(outputFileName);
const blob = new Blob([fileArray], {
type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
});
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = outputFileName;
a.click();
URL.revokeObjectURL(url);
};
return (
<div style={{ textAlign: 'center', height: '300px' }}>
<h1>插入分节符</h1>
<button onClick={insertSectionBreak}>生成</button>
</div>
);
}
export default App;
在“深度报道”前插入分节符后,前一部分保持单栏,后一部分为两栏并带分割线:

为什么示例选择 NoBreak
NoBreak 表示新节紧接当前内容,不强制分页。示例用它把单栏的“本期要闻”和两栏的“深度报道”放在同一页,便于对照。若希望新节从新的一页开始,把参数换成 SectionBreakType.NewPage 即可,其余代码不变。
分节符的类型只决定新节从哪里开始,不影响后续的栏数与分割线设置。
分节符插在哪里
InsertSectionBreak 作用于调用它的段落,把该段落之后的内容划入新节。示例在“深度报道”标题的前一个段落上调用,标题及其后的正文因此进入新节。
若插在文档最后一个段落之后,新节只有分节符本身而没有内容,看起来像“多出一页空白”。插入位置应选在真正需要分隔的两个段落之间,并在调用前确认索引有效。
分节后页面设置为什么会连带变化
新节默认继承前一节的页面设置,包括纸张、页边距与页眉页脚。示例只修改新节的栏数与分割线,其余属性保持不变。若希望新节回到单栏,应对新节显式设置栏数,而不是依赖默认值。
页眉页脚通过 LinkToPrevious 与前一节关联。需要各节独立设置页眉页脚时,先断开链接,再修改内容。
三个功能点的调用顺序
| 步骤 | 调用 | 影响范围 |
|---|---|---|
| 划分节 | paragraph.InsertSectionBreak(type) |
文档结构 |
| 设置栏 | section.Columns.Populate(count, spacing) |
当前节 |
| 显示分割线 | section.PageSetup.ColumnsLineBetween = true |
当前节 |
| 追加单栏 | section.AddColumn(width, spacing) |
当前节 |
先分节、后设栏,是较稳妥的顺序。若先设置栏再插入分节符,新节会继承旧节的栏数,需要再次调整。使用 AddColumn 追加栏时,记得随后调用 MakeColumnsSameWidth() 统一栏宽。
常见问题
设置两栏后,为什么看起来还像一栏
先确认修改的是目标节。示例文档有刊头和正文两节,只对正文节调用 Populate,刊头仍是一栏。其次确认栏数参数:Populate(2, 36) 的 2 是总栏数,不是新增栏数。若改用 AddColumn,它每次只追加一栏,从一栏变两栏调用一次;调用后建议再执行 MakeColumnsSameWidth(),否则原来的第一栏可能仍按整页宽度计算。
分栏后右栏从句子中间开始,正常吗
正常。Word 的栏间内容是连续流动的:左栏排满后,剩余文字接着从右栏顶部继续,所以右栏可能从半句话开始。若不希望跨栏断开,可以在合适的段落末尾插入分栏符,或改用分节符把内容划到新的节;也可以调整栏间距与字号,让断点落在段落边界附近。
分栏分割线怎么关闭
把该节的 PageSetup.ColumnsLineBetween 设为 false 即可,不需要删除栏或重建节。若文档中有多个节,逐个检查需要的节;新节会继承前一节的设置,插入分节符后如果不需要分割线,应在新节上显式关闭。
分节符和分页符有什么区别
分页符只把后续内容推到下一页,页面设置仍与当前节相同。分节符会创建新的节,新节可以拥有独立的纸张大小、页边距、页眉页脚与分栏数。需要“同一文档不同版式”时用分节符;只是换页时用分页符即可。
页眉页脚会跟着正文分栏吗
通常不会。页眉页脚按节设置,横跨页面宽度,不会随正文拆成两栏。分节后,新节的页眉页脚默认与前一节链接;需要不同内容时,先断开 LinkToPrevious,再单独编辑。
获取免费许可证
如果您希望删除结果文档中的评估消息,或者摆脱功能限制,请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。







