← Toda la documentación

editor.commitBookmark()

Finaliza la entrada de deshacer actual del editor. Normalmente, las ediciones consecutivas hechas en poco tiempo se agrupan en un solo paso de deshacer; al confirmar, el paso actual se da por terminado, así que el siguiente cambio empieza una entrada nueva que se puede deshacer por separado. Úsalo para trazar un límite claro en el historial de deshacer alrededor de un cambio hecho desde código.

Sintaxis

editor.commitBookmark()

Parámetros

Ninguno.

Valor devuelto

Nada (undefined).

Notas de comportamiento

  • Controla la granularidad del deshacer, no el contenido. Confirmar no cambia el documento; solo decide si la siguiente edición se une al paso de deshacer actual o empieza uno nuevo.
  • Las ediciones se agrupan de forma predeterminada. Sin una confirmación, los cambios que ocurren dentro de una ventana breve (el tiempo de espera del editor para añadir al historial de deshacer) se juntan en una sola entrada; confirmar fuerza el límite de inmediato.
  • Deshacer confirma automáticamente. El editor confirma el marcador pendiente antes de realizar un deshacer, así que rara vez lo necesitarás para la escritura normal: es más útil alrededor de ediciones hechas por script.

Ejemplo de uso

Rodea un cambio hecho desde código para que se convierta en su propio paso de deshacer:

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

Inserta varios fragmentos como pasos de deshacer separados en lugar de uno solo combinado:

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

Relacionado