← Toda la documentación

editor.closeCurrentPopup()

Cierra una ventana emergente abierta del editor (una lista desplegable, un menú o un panel de diálogo) y devuelve el foco al área de edición. Es especialmente útil dentro de listas desplegables personalizadas de la barra de herramientas, donde un botón del panel debe cerrar ese panel después de hacer su trabajo.

Sintaxis

editor.closeCurrentPopup()

Parámetros

Ninguno en el uso habitual. Llamado sin argumentos, cierra la ventana emergente abierta en ese momento. (Se puede pasar un objeto de panel concreto para cerrarlo a él, pero el código de las listas desplegables personalizadas normalmente lo llama sin argumentos).

Valor devuelto

Nada (undefined).

Notas de comportamiento

  • Gestiona las cadenas de submenús. Cuando el panel abierto pertenece a una ventana emergente superior, se desvincula de la lista de submenús de esa ventana y se ejecutan sus controladores de dispose/close, así que cerrar un menú anidado no deja ninguna referencia colgando.
  • El foco vuelve al editor. Después de cerrarse el panel, el foco del teclado vuelve al área de edición, para que el usuario pueda seguir escribiendo sin un clic adicional.
  • Cierra la ventana emergente, no el editor. Solo se descarta la lista desplegable, el menú o el diálogo transitorio; el documento y la selección no se tocan.

Ejemplo de uso

Dentro de una lista desplegable personalizada, cierra el panel después de que el usuario haga clic en uno de sus botones:

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

Relacionado