页面结构

页面结构涵盖控制内容如何跨页面流动的元素：分页符、节、页面大小、页边距和页码。分页符可在管道中完整往返。其他页面结构属性仅部分支持。

你需要了解的内容

• 扩展： @tiptap-pro/extension-pagebreak（不在 StarterKit 中）以及用于分页布局的 Pages
• 导出选项： 导出扩展或 REST API 上的 pageSize 和 pageMargins
• 集成路径： 通过 编辑器扩展 和 REST API 导入与导出都以相同方式工作。两种导出路径都接受 pageSize 和 pageMargins。

支持概览

分页符

分页符可在管道中完整往返。详见专门的分页符页面。

页面大小和页边距

DOCX 中的页面大小和页边距不会被导入。解析器会从节属性中读取它们，但 Tiptap 渲染器会丢弃这些信息。

Pages 扩展提供带可配置页面大小和页边距的分页布局。配置详情请参见页面格式指南。

导出扩展接受 pageSize 和 pageMargins 选项：

ExportDocx.configure({
  pageSize: {
    width: '21.0cm',
    height: '29.7cm',
  },
  pageMargins: {
    top: '2.54cm',
    bottom: '2.54cm',
    left: '3.17cm',
    right: '3.17cm',
  },
})

这些值支持 CSS 风格单位：cm、in、pt、pc、mm、px。默认值会生成带标准 Word 页边距的 A4 页面。

节

Word 文档可以有多个节，每个节都有自己的页面布局属性（大小、方向、页边距、栏、页眉/页脚）。转换管道对节的支持是部分的：

• 导入： 节边界用于检测多栏布局。多栏节会被包装为 columns/column Tiptap 节点。其他节级属性（大小、方向、页边距）会被解析，但不会应用。
• 编辑器： Tiptap 没有节的概念，但栏节点可以原生渲染。
• 导出： 生成单个节。无法创建纵向/横向混排或多节文档。

页码

Word 中的页码是位于页眉和页脚中的域代码（PAGE、NUMPAGES）。虽然页眉和页脚会被导入（见页眉和页脚），但页码字段不会被转换，因为导入管道不会解析 DOCX 域代码。

Pages 扩展支持在页眉和页脚内容中使用页码占位符（{page}、{total}）。

可往返内容