Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.
Desaprobado
This feature has been removed from the Web standards. Though some browsers may still support it, it is in the process of being dropped. Do not use it in old or new projects. Pages or Web apps using it may break at any time.
El método Window.showModalDialog() crea y visualiza una caja de diálogo modal, conteniendo el documento HTML especificado.
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 (bug 981796). 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
valRetornoes un valor indicando la propiedad returnValue establecida por la ventana del documento especificado por lauri.uriis es la URI del documento a visualizar en la caja de diálogo.argumentoses 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 propiedadwindow.dialogArgumentsdel objetowindow.opcioneses 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. |
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
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
<dialog>, un sustituo parawindow.showModalDialog().- showModalDialog Polyfill usando un
<dialog>y generadores