Window.showModalDialog()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since marzo de 2022.

Obsoleto: Esta característica ya no se recomienda. Aunque es posible que algunos navegadores aún lo admitan, probablemente ya se ha eliminado de los estándares web relevantes, está en proceso de eliminación o solo se conserva por motivos de compatibilidad. Evite usarlo y actualice el código existente si es posible; consulte la tabla de compatibilidad en la parte inferior de esta página para orientar su decisión. Tenga en cuenta que esta característica puede dejar de funcionar en cualquier momento.

El método Window.showModalDialog() crea y visualiza una caja de diálogo modal, conteniendo el documento HTML especificado.

Nota: Esta prestación va a desaparecer. Por favor ajuste sus sitios Web y aplicaciones.

El soporte ha sido eliminado en Chrome 37. Pero se añadió temporalmente un ajuste de Política Coporativa para rehabilitar showModalDialog. Este método showModalDialog() fue eliminado definitivamente en Chrome 43.

Mozilla ha anunciado que eliminará el soporte para este método (Error 981796 en Firefox). Sin plazo específico, debería ser antes de Firefox 46. Esto quiere decir que la función estará fuera de uso sobre mediados de junio de 2016. Una revisión ESR podría soportarla aun por algunas meses más.

Sintaxis

valRetorno = window.showModalDialog(uri[, argumentos][, opciones]);

donde

valRetorno es un valor indicando la propiedad returnValue establecida por la ventana del documento especificado por la uri.
uri is es la URI del documento a visualizar en la caja de diálogo.
argumentos es un parámetro adicional, que contiene valores que deberían ser pasados a la caja de diálogo; estos son puestos a disposición en el la propiedad window.dialogArguments del objeto window.
opciones es una cadena adicional que especifica ornamentaciones de ventana para la caja de diálogo, usando uno o más de los siguientes valores separados por punto y coma:

Sintaxis Descripción

center: {on \| off \| yes \| no \| 1 \| 0 }	Si el valor de este argumento es on, yes, ó 1, la ventana de diálogo será centrada en el escritorio; en caso contrario será oculta. El valor por defecto es yes.
dialogheight: height	Especifica la altura de la caja de diálogo; por defecto, el tamaño es especificado en pixels.
dialogleft: left	Especifica la posición horizontal de la caja de diálogo respecto de la esquina superior izquierda del escritorio.
dialogwidth: width	Especifica la anchura de la caja de diálogo; por defecto el tamaño es especificado en pixels.
dialogtop: top	Especifica la posición vertical de la caja de diálogo, respcto de la esquina superior izquierda del escritorio.
resizable: {on \| off \| yes \| no \| 1 \| 0 }	Si el valor de este argumentoes on, yes, ó 1, la ventana de diálogo podrá ser redimensionada por el usuario; en caso controario su tamaño será fijo. El valor por defecto es no.
scroll: {on \| off \| yes \| no \| 1 \| 0 }	Si el valor de este argumento es on, yes, ó 1, la ventana de diálogo tendrá barras de desplazamiento; en caso contrario su tamaño será fijo. El valor por defecto es no.

Nota: Firefox no implementa los argumentos dialogHide, edge, status, ó unadorned.

<dialog>, un sustituo para window.showModalDialog().
showModalDialog Polyfill usando un <dialog> y generadores

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 8 may 2026 by MDN contributors.

View this page on GitHub • Report a problem with this content

Window.showModalDialog()

In this article

Sintaxis

Compatibilidad con navegadores

Ejemplos

Notas

Especificación

Ver también

Help improve MDN