跳到正文
lit-docx
开发者文档
预览版 · 未发布

支持范围

各项 Word 功能在读取(parseDocx)与生成(generateDocx)两个方向上的支持情况。

“读取”指 parseDocx 把它转成有语义的节点;“生成”指 generateDocx 能从节点写出它。“原样写回”表示内容能保留到输出文件,但不能通过 LitAST 新建或修改。

功能读取生成
段落:对齐、间距、缩进、制表位✅✅
文字格式:粗体、斜体、下划线、删除线、上下标、字号、颜色、字体、高亮✅✅
标题、引用、代码块、水平线✅✅
列表与多级编号✅✅ 自动生成编号定义
表格:合并单元格、列宽、底纹、边框、标题行✅✅
图片:嵌入、浮动、裁剪、超链接✅✅
文本框与形状✅原样写回
分节、页面设置、页眉页脚(含首页、奇偶页)✅✅
域:页码、日期、目录与复杂域✅✅
内容控件:文本、复选框、日期、下拉列表、重复节、数据绑定、图片✅✅
批注与回复✅✅
修订:插入、删除、格式修改、移动✅✅
脚注与尾注✅✅
书签、编辑权限区域、分页符、分栏符✅✅
文档属性与文档变量✅✅
文档保护✅✅
公式(OMML)原样保留原样写回
图表原样保留原样写回,不能新建
水印✅原样写回
样式定义用于计算格式,原始部件保留原样写回,不能通过 LitAST 新建样式
拼音指南(ruby)✅ 基文、注音及属性✅ 新建、修改、写回;见生成示例

已知限制

  • generateDocx 根据 LitAST 重建整个包,文档部件库(glossary)与自定义 XML 部件不会写回,见往返与保留。
  • 加密的 DOCX 与旧版 .doc 无法读取,会抛出 DocxPackageError。
  • 不负责排版与渲染:lit-docx 只处理文件结构,不计算分页,也不把文档画出来。
  • 拼音指南不会自动推断汉字读音。支持两层文字及格式、六种对齐值、字号、抬升量、语言与 dirty;复杂嵌套域/批注/修订的完整生命周期尚未验收。不符合 ruby 内容模型的节点会拒绝导出,不会无声丢弃。
lit-docx · QuireKitDOCX 解析与生成库,AGPL-3.0 许可,可另购商业授权。