OOJSON 格式转换
提供 Word OOJSON 与 OOXML / Flat OPC 转换,以及 PPT 内容和模型适配。将格式接入与真实宿主写回分开处理。
从宿主数据,到文档处理。
转换结果与诊断信息一并交给调用方。
输入ONLYOFFICE-shaped JSON
⇄
Word 段落、文本与表格
转换OOJSON
⇄
转换结果 + gaps / diagnostics
输出OOXML / Flat OPC
连接 Core 文档包处理
import { jsonToOoxml, ooxmlToJson }
from '@coco-vexel/coco-office-oojson';
const input = {
type: 'document',
content: [{
type: 'paragraph', pPr: {},
content: [{ type: 'run', rPr: {}, content: ['Hello Coco'] }],
}],
};
const xml = jsonToOoxml(input);
const { doc, gaps } = ooxmlToJson(xml);
// 检查 gaps,了解未映射的内容;xml 不是 DOCX ZIP 字节。
在接入前,确认这些边界。
转换成功与真实编辑器写回成功,需要分别验证。
| 范围 | 说明 |
|---|---|
| Word | 正文 JSON ↔ OOXML / Flat OPC,包含受支持的段落、文本、表格及格式。 |
| PPT | 文本内容与 Core text body、deck 与 Core model 适配;高级几何、图表、动画有范围限制。 |
| Excel | 不是 Excel JSON 转换器。 |
| 运行时 | ESM JavaScript,面向 Node.js 和浏览器打包;初始版本不含 TypeScript 声明或 CommonJS 入口。 |
| 宿主写回 | 由独立适配器应用转换结果,并检查 gaps 与写回 diagnostics;转换库不直接修改实时编辑器。 |
从格式转换,继续走向文档操作。
通过 Core 完成文档包读取、修改与导出。