← Toute la documentation

editor.closeCurrentPopup()

Ferme une fenêtre contextuelle ouverte de l’éditeur — une liste déroulante, un menu ou un panneau de boîte de dialogue — et rend le focus à la zone d’édition. Elle est surtout utile dans les listes déroulantes personnalisées de la barre d’outils, où un bouton du panneau doit fermer ce panneau après avoir fait son travail.

Syntaxe

editor.closeCurrentPopup()

Paramètres

Aucun dans l’usage courant. Appelée sans argument, elle ferme la fenêtre contextuelle ouverte. (On peut transmettre un objet panneau précis pour le cibler, mais le code des listes déroulantes personnalisées l’appelle normalement sans argument.)

Valeur renvoyée

Rien (undefined).

Remarques sur le comportement

  • Les chaînes de sous-menus sont gérées. Lorsque le panneau ouvert appartient à une fenêtre contextuelle parente, il est retiré de la liste des sous-menus de ce parent et ses gestionnaires dispose/close s’exécutent — fermer un menu imbriqué ne laisse donc pas de référence orpheline.
  • Le focus revient à l’éditeur. Après la fermeture du panneau, le focus clavier est rendu à la zone d’édition : l’utilisateur peut continuer à taper sans clic supplémentaire.
  • Elle ferme la fenêtre contextuelle, pas l’éditeur. Seuls la liste déroulante, le menu ou la boîte de dialogue temporaires sont fermés ; le document et la sélection ne sont pas touchés.

Exemple d’utilisation

Dans une liste déroulante personnalisée, fermer le panneau après que l’utilisateur a cliqué sur l’un de ses boutons :

option.fillpanel = function (panel) {
    var btn = document.createElement("button");
    btn.textContent = "Insert signature";
    btn.onclick = function () {
        editor.closeCurrentPopup();   // dismiss the dropdown
        editor.insertHTML("<p>-- <br/>Sent from RichTextEditor</p>");
        return false;
    };
    panel.appendChild(btn);
};

var btn = editor.createToolbarDropDown(option, cmd, suffix);

Voir aussi