← Toute la documentation

editor.clearHistory()

Vide les piles d’annulation et de rétablissement. Le contenu du document n’est pas touché — seul l’historique enregistré est effacé. Appelez-la après avoir chargé un nouveau document par programmation, pour que l’utilisateur ne puisse pas annuler au-delà du contenu que vous venez de définir.

Syntaxe

editor.clearHistory()

Paramètres

Aucun.

Valeur renvoyée

Rien (undefined).

Remarques sur le comportement

  • Le contenu n’est pas affecté. Effacer l’historique ne supprime que les enregistrements d’annulation et de rétablissement ; le contenu de l’éditeur reste exactement tel quel.
  • L’état de la barre d’outils est actualisé. Une fois les piles vidées, l’éditeur réévalue l’état de sa sélection : les boutons Undo et Redo de la barre d’outils s’affichent donc bien comme désactivés.
  • Associez-la à un chargement par programmation. Définir le contenu avec setHTMLCode ajoute une entrée d’annulation ; appeler clearHistory() juste après fait de cet état chargé un point de départ propre.

Exemple d’utilisation

Charger un document et en faire la base au-delà de laquelle l’utilisateur ne peut pas annuler :

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

Réinitialiser l’éditeur lors du passage à un autre enregistrement dans une application monopage :

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

Voir aussi