文档辅助
文档辅助扩展可处理整个文档:收集标题以生成目录、在文档末尾保留一个空节点,并为节点分配唯一 ID。
使用场景
- 文档导航。 Table of contents 会收集文档中的标题和其他锚点,以及它们的层级、ID 和滚动状态,你可以据此自行渲染目录。
- 在最后一个块后添加节点。 Trailing node 会在编辑器的最后一个块节点之后添加节点。
- 引用节点。 Unique ID 会为你配置的节点类型分配 ID;用户拆分、合并、粘贴或撤销操作时,ID 会随节点保留。
工作原理
- 它们都是扩展。 它们会处理文档中的节点,但不会自行添加节点或标记。扩展
- StarterKit 自带 Trailing node。 它属于 StarterKit;Table of contents 和 Unique ID 需要手动添加。
- 目录由你渲染。
onUpdate回调会接收锚点,你可以使用任意框架或原生 DOM 代码渲染目录。 - 在服务端生成 ID。
generateTocIds和generateUniqueIds无需编辑器实例即可为 JSON 文档添加 ID。 - 协作时在同步后挂载。 将 Unique ID 与 Collaboration 搭配使用时,请等协作 provider 完成同步后再挂载编辑器。