← Toute la documentation

editor.focus()

Place le focus clavier dans l’éditeur pour que l’utilisateur puisse commencer à taper sans cliquer d’abord. Utilisez-la après la création de l’éditeur, après l’insertion de contenu par programmation, ou après la fermeture d’une boîte de dialogue ou d’un panneau latéral qui avait retiré le focus de la zone d’édition.

Syntaxe

editor.focus()

Paramètres

Aucun.

Valeur renvoyée

Rien (undefined).

Remarques sur le comportement

focus() n’est pas une simple enveloppe de l’appel focus natif du DOM — elle tient compte des différents modes de l’éditeur et des particularités des navigateurs en matière de sélection :

  • Mode code. Lorsque l’éditeur affiche le source HTML, le focus est dirigé vers l’éditeur de code plutôt que vers la zone de texte enrichi : l’appel fait donc ce qu’il faut dans les deux modes.
  • Un contrôle sélectionné l’emporte. Si un contrôle, comme une image, est actuellement sélectionné, focus() rend la main sans rien changer. C’est voulu : un appel focus fait par programmation ne doit pas faire perdre silencieusement à l’utilisateur la sélection de son image (ni les poignées de redimensionnement qui vont avec).
  • Le curseur est conservé. Certains navigateurs abandonnent la sélection courante lorsque le focus entre dans le cadre d’édition. L’éditeur réapplique ensuite la plage mémorisée : le curseur reste donc là où l’utilisateur l’avait laissé au lieu de sauter en haut du document.

Exemple d’utilisation

Placer le focus dans l’éditeur dès qu’il est prêt, pour que la page soit immédiatement utilisable au clavier :

var editor1 = new RichTextEditor("#div_editor1");
editor1.focus();

Insérer un fragment, puis rendre le focus à l’éditeur pour que la saisie continue naturellement :

document.getElementById("btn_signature").onclick = function () {
    editor1.insertHTML("<p>-- <br/>Sent from RichTextEditor</p>");
    editor1.focus();   // the button took focus on click; give it back
};

Placer le focus après avoir affiché un éditeur masqué. Donner le focus à un élément encore en display:none n’a aucun effet : affichez-le d’abord.

function openComposer() {
    document.getElementById("composer").style.display = "block";
    editor1.focus();
}

Voir aussi