基本用法

Paid add-on

了解使用变更跟踪扩展的基本工作流程——启用建议模式、管理用户以及审阅建议。

启用和禁用变更跟踪

切换变更跟踪模式的开启和关闭：

// 启用变更跟踪
editor.commands.enableTrackedChanges()

// 禁用变更跟踪
editor.commands.disableTrackedChanges()

// 切换变更跟踪状态
editor.commands.toggleTrackedChanges()

设置当前用户

更改新建议的用户：

editor.commands.setTrackedChangesUser({
  userId: 'user-456',
  userMetadata: { name: 'Jane Smith' },
})

接受和拒绝建议

单独接受或拒绝建议：

// 接受当前位置的建议
editor.commands.acceptSuggestion()

// 拒绝当前位置的建议
editor.commands.rejectSuggestion()

// 根据 ID 接受特定建议
editor.commands.acceptSuggestion({ id: 'suggestion-123' })

// 根据 ID 拒绝特定建议
editor.commands.rejectSuggestion({ id: 'suggestion-123' })

格式变更通过相同的建议工作流程进行审阅。被跟踪的粗体、斜体、链接或其他标记变更会显示为 markChange 建议，并且可以像插入、删除或替换一样被接受或拒绝。

如果你需要从应用逻辑中创建格式建议，请使用命令参考中描述的程序化标记命令：addTrackedMark、removeTrackedMark 和 toggleTrackedMark。

批量操作

一次性接受或拒绝所有建议：

// 接受所有建议
editor.commands.acceptAllSuggestions()

// 拒绝所有建议
editor.commands.rejectAllSuggestions()

接受或拒绝特定文档范围内的建议：

// 接受范围内的建议
editor.commands.acceptSuggestionsInRange({ from: 10, to: 50 })

// 拒绝范围内的建议
editor.commands.rejectSuggestionsInRange({ from: 10, to: 50 })

接受或拒绝特定用户的所有建议：

// 接受某用户的所有建议
editor.commands.acceptSuggestionsByUser({ userId: 'user-123' })

// 拒绝某用户的所有建议
editor.commands.rejectSuggestionsByUser({ userId: 'user-123' })

Previously安装

Next up高级用法