比较文档

文档比较功能将两个文档之间的差异以修订标记的形式高亮显示，用户可以逐一接受或拒绝每个更改。

下图和步骤说明了比较流程。

1. 用户在浏览器中使用文档管理器打开文档进行查看或编辑。
2. 文档管理器使用包含 onRequestSelectDocument 事件处理程序的 config 初始化文档编辑器。
3. 文件被打开进行编辑。
4. 用户点击比较菜单中的来自存储的文档按钮。文档编辑器触发 onRequestSelectDocument 事件，data.c 设置为 "compare"。
5. 文档管理器允许用户从存储中选择要比较的文档。
6. 文档管理器调用 setRequestedDocument 方法，传递所选文档的 URL 和 c: "compare" 参数给文档编辑器进行比较。

实际操作方法

1. 创建一个 .html 文件，用于打开文件。

2. 将 onRequestSelectDocument 事件处理程序添加到编辑器配置中。当用户点击比较菜单中的来自存储的文档按钮时，会触发此事件，data.c 设置为 "compare"。处理程序调用 setRequestedDocument 传递比较文档：

   

   const docEditor = new DocsAPI.DocEditor("placeholder", {
     events: {
       onRequestSelectDocument(event) {
         docEditor.setRequestedDocument({
           c: event.data.c,
           fileType: "docx",
           token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmaWxlVHlwZSI6ImRvY3giLCJ1cmwiOiJodHRwczovL2V4YW1wbGUuY29tL3VybC10by1leGFtcGxlLWRvY3VtZW50LmRvY3gifQ.t8660n_GmxJIppxcwkr_mUxmXYtE8cg-jF2cTLMtuk8",
           url: "https://example.com/url-to-example-document.docx",
         });
       },
     },
   });

   警告

   token 必须使用文档服务器的 JWT 密钥签名——上面的示例令牌使用的是临时密钥，无法在您的服务器上通过验证。每次参数更改时都需要重新生成令牌。详情请参阅安全。

3. 比较加载完成后，用户可以使用顶部工具栏上的相应按钮来接受或拒绝更改。

   

用户完成审阅后，文档会连同已接受的更改一起保存。