← Gesamte Dokumentation

editor.closeCurrentPopup()

Schließt ein geöffnetes Popup des Editors – ein Dropdown, ein Menü oder ein Dialogfeld – und gibt den Fokus an den Bearbeitungsbereich zurück. Am nützlichsten ist die Methode in eigenen Symbolleisten-Dropdowns, in denen eine Schaltfläche im Panel dieses Panel schließen soll, nachdem sie ihre Aufgabe erledigt hat.

Syntax

editor.closeCurrentPopup()

Parameter

Im üblichen Gebrauch keine. Ohne Argumente aufgerufen, schließt die Methode das gerade geöffnete Popup. (Man kann ein bestimmtes Panel-Objekt übergeben, um gezielt dieses zu schließen, aber Code für eigene Dropdowns ruft sie normalerweise einfach ohne Argumente auf.)

Rückgabewert

Nichts (undefined).

Hinweise zum Verhalten

  • Ketten von Untermenüs werden berücksichtigt. Gehört das geöffnete Panel zu einem übergeordneten Popup, wird es aus dessen Liste der Untermenüs entfernt, und seine Dispose- und Close-Handler laufen – das Schließen eines verschachtelten Menüs hinterlässt also keine verwaiste Referenz.
  • Der Fokus kehrt zum Editor zurück. Nachdem das Panel geschlossen ist, wird der Tastaturfokus an den Bearbeitungsbereich zurückgegeben, sodass der Benutzer ohne zusätzlichen Klick weitertippen kann.
  • Die Methode schließt das Popup, nicht den Editor. Nur das vorübergehende Dropdown, Menü oder der Dialog wird geschlossen; Dokument und Auswahl bleiben unberührt.

Anwendungsbeispiel

In einem eigenen Dropdown das Panel schließen, nachdem der Benutzer darin auf eine Schaltfläche geklickt hat:

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);

Siehe auch