← Toda a documentação

editor.closeCurrentPopup()

Fecha um pop-up aberto do editor — um menu suspenso, um menu ou um painel de caixa de diálogo — e devolve o foco à área de edição. É mais útil dentro de menus suspensos personalizados da barra de ferramentas, quando um botão no painel deve fechar esse painel depois de fazer o seu trabalho.

Sintaxe

editor.closeCurrentPopup()

Parâmetros

Nenhum, no uso típico. Chamado sem argumentos, fecha o pop-up aberto no momento. (É possível passar um objeto de painel específico para fechá-lo, mas o código de menus suspensos personalizados normalmente o chama sem argumentos.)

Retorno

Nada (undefined).

Observações de comportamento

  • Cadeias de submenus são tratadas. Quando o painel aberto pertence a um pop-up pai, ele é removido da lista de submenus desse pai e os handlers de dispose/close dele são executados — assim, fechar um menu aninhado não deixa uma referência solta.
  • O foco volta para o editor. Depois que o painel fecha, o foco do teclado é devolvido à área de edição, e o usuário pode continuar digitando sem um clique extra.
  • Fecha o pop-up, não o editor. Só o menu suspenso, menu ou caixa de diálogo temporário é fechado; o documento e a seleção não são alterados.

Exemplo de uso

Dentro de um menu suspenso personalizado, feche o painel depois que o usuário clicar em um botão dele:

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

Relacionados