← Toute la documentation

editor.collapse(bStart)

Réduit la sélection courante à un seul point d’insertion (un curseur sans texte surligné). Utilisez-la après une sélection faite par programmation ou une commande qui a agi sur une plage, lorsque vous voulez placer le curseur à l’une des extrémités de ce qui était sélectionné plutôt que de laisser toute la plage surlignée.

Syntaxe

editor.collapse(bStart)

Paramètres

bStart — booléen. true réduit la sélection à son début, false à sa fin. L’omettre revient à false (réduction à la fin).

Valeur renvoyée

Rien (undefined).

Remarques sur le comportement

  • Une sélection déjà réduite reste telle quelle. Si la sélection est déjà un curseur, collapse() rend la main immédiatement sans le déplacer.
  • Sans plage active, le document est d’abord sélectionné. S’il n’y a aucune plage de sélection (par exemple parce que l’éditeur n’a pas encore reçu le focus), collapse() se rabat sur la sélection de tout le document : l’appel laisse donc toujours une sélection bien définie sur laquelle travailler.
  • Elle agit sur la sélection en direct, celle que voit l’utilisateur — il n’y a pas de curseur séparé à synchroniser.

Exemple d’utilisation

Appliquer une commande à tout le document, puis placer le curseur à la fin pour que la saisie continue après :

var editor1 = new RichTextEditor("#div_editor1");
editor1.setHTMLCode("<b>hello world</b>");
editor1.selectDoc();
editor1.execCommand("forecolor", "red");
editor1.collapse(false);   // caret lands after the colored text

Réduire plutôt au début, pour placer le curseur avant la sélection :

editor1.selectDoc();
editor1.collapse(true);    // caret lands at the very beginning

Voir aussi