Window.showModalDialog()
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Warning: This feature has been removed. Please fix your Web sites and applications.
This method was removed in Chrome 43 and Firefox 56.
The Window.showModalDialog()
created and displayed a modal dialog box containing a specified HTML document.
Syntax
returnVal = window.showModalDialog(uri[, arguments][, options]);
-
returnVal
holds thereturnValue
property as set by the document specified byuri
. uri
is the URL of the document to display in the dialog.-
arguments
is an optional variant containing values passed to the dialog; these are made available in thewindow
object'swindow.dialogArguments
property. -
options
is an optional string specifying window ornamentation for the dialog, using one or more semicolon delimited values:
Syntax | Description |
---|---|
center: {on | off | yes | no | 1 | 0 } |
If on , yes , or 1 , the dialog
window is centered on the desktop; otherwise it's hidden. Default is
yes .
|
dialogheight: height |
The height of the dialog box in pixels. |
dialogleft: left |
Distance of the dialog box from the left edge of the desktop. |
dialogwidth: width |
The width of the dialog box in pixels. |
dialogtop: top |
Distance of the dialog box from the top edge of the desktop. |
resizable: {on | off | yes | no | 1 | 0 } |
If this argument's value is on , yes , or 1, the
dialog window can be resized by the user; otherwise its size is fixed.
The default value is no .
|
scroll: {on | off | yes | no | 1 | 0 } |
If on , yes , or 1, the dialog window has scroll
bars; otherwise its size is fixed. Default is no .
|
Note: Firefox does not implement the dialogHide
, edge
, status
, or unadorned
arguments.
Notes
showModalDialog()
was briefly standardized as part of HTML5. The third
argument for additional options was not present in the HTML5 version.
Specifications
Browser compatibility
BCD tables only load in the browser
See also
<dialog>
, a replacement forwindow.showModalDialog()
.-
showModalDialog Polyfill
using a
<dialog>
and generators