← Gesamte Dokumentation

editor.commitBookmark()

Schließt den aktuellen Rückgängig-Eintrag des Editors ab. Normalerweise werden kurz aufeinanderfolgende Änderungen zu einem einzigen Rückgängig-Schritt zusammengefasst; das Abschließen markiert den aktuellen Schritt als fertig, sodass die nächste Änderung einen neuen, separat rückgängig zu machenden Eintrag beginnt. Damit ziehen Sie im Rückgängig-Verlauf eine saubere Grenze um eine Änderung per Code.

Syntax

editor.commitBookmark()

Parameter

Keine.

Rückgabewert

Nichts (undefined).

Hinweise zum Verhalten

  • Die Methode steuert die Granularität von Rückgängig, nicht den Inhalt. Das Abschließen ändert das Dokument nicht; es entscheidet nur, ob die nächste Änderung in den aktuellen Rückgängig-Schritt einfließt oder einen neuen beginnt.
  • Änderungen werden standardmäßig zusammengefasst. Ohne Abschluss fließen Änderungen innerhalb eines kurzen Zeitfensters (das Timeout des Editors für das Hinzufügen zum Rückgängig-Verlauf) in einen Eintrag ein – das Abschließen setzt die Grenze sofort.
  • Rückgängig schließt automatisch ab. Der Editor schließt das ausstehende Bookmark ab, bevor er etwas rückgängig macht, daher brauchen Sie die Methode beim normalen Tippen selten – am nützlichsten ist sie rund um Änderungen per Skript.

Anwendungsbeispiel

Eine Änderung per Code einklammern, sodass sie ein eigener Rückgängig-Schritt wird:

var editor1 = new RichTextEditor("#div_editor1");
editor1.commitBookmark();               // close whatever came before
editor1.setHTMLCode("<b>hello world</b>");
editor1.commitBookmark();               // this insert is now its own undo step

Mehrere Fragmente als getrennte Rückgängig-Schritte einfügen statt als einen zusammengefassten Schritt:

fragments.forEach(function (html) {
    editor1.insertHTML(html);
    editor1.commitBookmark();   // each fragment undoes independently
});

Siehe auch