← Toda la documentación

editor.clearHistory()

Vacía las pilas de deshacer y rehacer. El contenido del documento no se toca: solo se borra el historial registrado. Llámalo después de cargar un documento nuevo desde código, para que el usuario no pueda deshacer más allá del contenido que acabas de establecer.

Sintaxis

editor.clearHistory()

Parámetros

Ninguno.

Valor devuelto

Nada (undefined).

Notas de comportamiento

  • No afecta al contenido. Borrar el historial solo elimina los registros de deshacer y rehacer; lo que haya en el editor se queda exactamente como está.
  • El estado de la barra de herramientas se actualiza. Después de vaciar las pilas, el editor vuelve a evaluar el estado de su selección, así que los botones Undo y Redo de la barra de herramientas aparecen correctamente desactivados.
  • Combínalo con una carga desde código. Establecer contenido con setHTMLCode añade una entrada de deshacer; llamar a clearHistory() justo después hace que ese estado cargado sea el punto de partida limpio.

Ejemplo de uso

Carga un documento y conviértelo en la base más allá de la cual el usuario no puede deshacer:

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

Restablece el editor al cambiar a otro registro en una aplicación de una sola página:

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

Relacionado