← Gesamte Dokumentation

editor.clearHistory()

Leert den Rückgängig- und den Wiederherstellen-Stapel. Der Inhalt des Dokuments bleibt unberührt – nur der aufgezeichnete Verlauf wird gelöscht. Rufen Sie die Methode auf, nachdem Sie per Code ein neues Dokument geladen haben, damit der Benutzer nicht hinter den gerade gesetzten Inhalt zurückgehen kann.

Syntax

editor.clearHistory()

Parameter

Keine.

Rückgabewert

Nichts (undefined).

Hinweise zum Verhalten

  • Der Inhalt bleibt unverändert. Das Löschen des Verlaufs entfernt nur die Einträge für Rückgängig/Wiederherstellen; was im Editor steht, bleibt genau so, wie es ist.
  • Der Zustand der Symbolleiste wird aktualisiert. Nachdem die Stapel geleert sind, wertet der Editor seinen Auswahlzustand neu aus, sodass die Symbolleisten-Schaltflächen für Rückgängig und Wiederherstellen korrekt als deaktiviert erscheinen.
  • Mit einem Laden per Code kombinieren. Das Setzen von Inhalt mit setHTMLCode legt einen Rückgängig-Eintrag an; ein Aufruf von clearHistory() direkt danach macht den geladenen Zustand zum sauberen Ausgangspunkt.

Anwendungsbeispiel

Ein Dokument laden und zum Ausgangspunkt machen, hinter den der Benutzer nicht zurückgehen kann:

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

Den Editor zurücksetzen, wenn in einer Single-Page-App zu einem anderen Datensatz gewechselt wird:

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

Siehe auch