← 全部文档

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

相关内容