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

* MSDN page for `showModalDialog`
* Diálogos HTML5 implementados usando documentos separados
Ver también
-----------

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