← Toute la documentation

editor.delete()

Supprime ce qui est actuellement sélectionné dans l’éditeur. Avec une plage de texte sélectionnée, elle supprime ce texte ; avec un contrôle sélectionné, comme une image, elle supprime l’image. C’est l’équivalent par programmation d’un utilisateur qui sélectionne du contenu et appuie sur Suppr.

Syntaxe

editor.delete()

Paramètres

Aucun.

Valeur renvoyée

Rien (undefined).

Remarques sur le comportement

  • Un contrôle sélectionné a la priorité. Si un contrôle (une image, par exemple) est sélectionné, delete() supprime ce nœud et place le curseur à sa place, quel que soit l’état de la sélection de texte.
  • Un curseur réduit ne supprime rien. Quand la sélection n’est qu’un curseur sans texte surligné, delete() ne fait rien — elle ne supprime pas le caractère suivant. Sélectionnez d’abord une plage si vous avez besoin de supprimer du contenu.
  • Une plage de texte est supprimée sur place, et le contenu environnant se rejoint comme prévu.

Exemple d’utilisation

Sélectionner tout le document et l’effacer :

var editor1 = new RichTextEditor("#div_editor1");
editor1.setHTMLCode("<b>hello world</b>");
editor1.selectDoc();
editor1.delete();

Supprimer un contrôle précis — sélectionnez-le d’abord, puis supprimez-le. Ici, l’image sélectionnée est supprimée :

var img = editor1.getEditable().querySelector("img");
if (img) {
    editor1.selectControl(img);
    editor1.delete();
}

Voir aussi