← 全部文档

editor.clearHistory()

清空撤销栈和重做栈。文档内容不受影响——只清除记录的历史。以编程方式加载一份新文档后调用它，用户就无法通过撤销回到您刚设置的内容之前。

语法

editor.clearHistory()

参数

无。

返回值

无（undefined）。

行为说明

  • 内容不受影响。清除历史只会删除撤销/重做记录；编辑器中的内容保持原样。
  • 工具栏状态会刷新。清空两个栈之后，编辑器会重新评估选区状态，因此 Undo 和 Redo 工具栏按钮会正确地显示为禁用。
  • 与编程方式的加载配合使用。用 setHTMLCode 设置内容会推入一个撤销条目；紧接着调用 clearHistory()，就能让加载后的状态成为干净的起点。

用法示例

加载一份文档，并让它成为用户无法撤销越过的基准：

var editor1 = new RichTextEditor("#div_editor1");
editor1.setHTMLCode(loadedDocumentHtml);
editor1.clearHistory();   // fresh start; Undo is now disabled

在单页应用中切换到另一条记录时重置编辑器：

function openRecord(html) {
    editor1.setHTMLCode(html);
    editor1.clearHistory();
}

相关内容