Window.showModalDialog()

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

js
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.

Compatibilidad con navegadores

Introducido por Microsoft Internet Explorer 4. Soporte añadido a Firefox en Firefox 3 (desaconsejado en Fx 28), y a Safari en Safari 5.1. Ver WebKit bug 151885 para posible futura eliminación de Safari.

Ejemplos

Probar showModalDialog().

Notas

showModalDialog() está siendo estandarizado actualmente como parte de HTML5. El tercer argumento (para opciones adicionales) no está presente en la versión HTML5, y es (seguramente) ignorado por Safari and Chrome.

Especificación

Ver también