← すべてのドキュメント

editor.closeCurrentPopup()

開いているエディターのポップアップ（ドロップダウン、メニュー、ダイアログのパネル）を閉じ、編集領域にフォーカスを戻します。もっとも役立つのはカスタムのツールバードロップダウンの中で、パネル内のボタンが処理を終えた後にそのパネルを閉じたい場合です。

構文

editor.closeCurrentPopup()

パラメーター

通常の使い方ではなし。引数なしで呼び出すと、現在開いているポップアップを閉じます（特定のパネルオブジェクトを渡して対象を指定することもできますが、カスタムのドロップダウンのコードでは通常、引数なしで呼び出すだけです）。

戻り値

なし（undefined）。

動作に関する注意

  • サブメニューの連鎖にも対応します。開いているパネルが親のポップアップに属している場合、そのパネルは親のサブメニューの一覧から切り離され、dispose／close のハンドラーが実行されます。そのため、入れ子のメニューを閉じても参照が残ることはありません。
  • フォーカスはエディターに戻ります。パネルが閉じた後、キーボードフォーカスは編集領域に戻されるので、ユーザーは余分なクリックなしで入力を続けられます。
  • 閉じるのはポップアップで、エディターではありません。閉じられるのは一時的なドロップダウン／メニュー／ダイアログだけで、文書と選択範囲はそのままです。

使用例

カスタムのドロップダウンの中で、ユーザーがパネル内のボタンをクリックした後にパネルを閉じます。

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

関連項目