“读取”指 parseDocx 把它转成有语义的节点;“生成”指 generateDocx 能从节点写出它。“原样写回”表示内容能保留到输出文件,但不能通过 LitAST 新建或修改。
| 功能 | 读取 | 生成 |
|---|---|---|
| 段落:对齐、间距、缩进、制表位 | ✅ | ✅ |
| 文字格式:粗体、斜体、下划线、删除线、上下标、字号、颜色、字体、高亮 | ✅ | ✅ |
| 标题、引用、代码块、水平线 | ✅ | ✅ |
| 列表与多级编号 | ✅ | ✅ 自动生成编号定义 |
| 表格:合并单元格、列宽、底纹、边框、标题行 | ✅ | ✅ |
| 图片:嵌入、浮动、裁剪、超链接 | ✅ | ✅ |
| 文本框与形状 | ✅ | 原样写回 |
| 分节、页面设置、页眉页脚(含首页、奇偶页) | ✅ | ✅ |
| 域:页码、日期、目录与复杂域 | ✅ | ✅ |
| 内容控件:文本、复选框、日期、下拉列表、重复节、数据绑定、图片 | ✅ | ✅ |
| 批注与回复 | ✅ | ✅ |
| 修订:插入、删除、格式修改、移动 | ✅ | ✅ |
| 脚注与尾注 | ✅ | ✅ |
| 书签、编辑权限区域、分页符、分栏符 | ✅ | ✅ |
| 文档属性与文档变量 | ✅ | ✅ |
| 文档保护 | ✅ | ✅ |
| 公式(OMML) | 原样保留 | 原样写回 |
| 图表 | 原样保留 | 原样写回,不能新建 |
| 水印 | ✅ | 原样写回 |
| 样式定义 | 用于计算格式,原始部件保留 | 原样写回,不能通过 LitAST 新建样式 |
| 拼音指南(ruby) | ✅ 基文、注音及属性 | ✅ 新建、修改、写回;见生成示例 |
已知限制
generateDocx根据 LitAST 重建整个包,文档部件库(glossary)与自定义 XML 部件不会写回,见往返与保留。- 加密的 DOCX 与旧版
.doc无法读取,会抛出DocxPackageError。 - 不负责排版与渲染:lit-docx 只处理文件结构,不计算分页,也不把文档画出来。
- 拼音指南不会自动推断汉字读音。支持两层文字及格式、六种对齐值、字号、抬升量、语言与
dirty;复杂嵌套域/批注/修订的完整生命周期尚未验收。不符合 ruby 内容模型的节点会拒绝导出,不会无声丢弃。