Window.showModalDialog()

Jump to:
  1. Syntax
  2. Examples
  3. Notes
  4. Specification
  5. Browser compatibility
  6. See also

Obsolete
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.

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() creates and displays a modal dialog box containing a specified HTML document.

Syntax

returnVal = window.showModalDialog(uri[, arguments][, options]);

where

  • returnVal is a variant, indicating the returnValue property as set by the window of the document specified by uri.
  • uri is the URI of the document to display in the dialog box.
  • arguments is an optional variant that contains values that should be passed to the dialog box; these are made available in the window object's window.dialogArguments property.
  • options an optional string that specifies window ornamentation for the dialog box, using one or more semicolon delimited values:
Syntax Description
center: {on | off | yes | no | 1 | 0 } If this argument's value is on, yes, or 1, the dialog window is centered on the desktop; otherwise it's hidden. The default value is yes.
dialogheight: height Specifies the height of the dialog box; by default, the size is specified in pixels.
dialogleft: left Specifies the horizontal position of the dialog box in relation to the upper-left corner of the desktop.
dialogwidth: width Specifies the width of the dialog box; by default, the size is specified in pixels.
dialogtop: top Specifies the vertical position of the dialog box in relation to the upper-left corner 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 this argument's value is on, yes, or 1, the dialog window has scroll bars; otherwise its size is fixed. The default value is no.

Note: Firefox does not implement the dialogHide, edge, status, or unadorned arguments.

Examples

Try out showModalDialog().

Notes

showModalDialog() is currently being standardized as part of HTML5. The third argument (for additional options) is not present in the HTML5 version, and is (safely) ignored by both Safari and Chrome.

Specification

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Basic support
DeprecatedNon-standard
Chrome No support ? — 43Edge No support NoFirefox No support 3 — 56IE Full support 4Opera No support NoSafari Full support 5.1
Notes
Full support 5.1
Notes
Notes See WebKit bug 151885 for possible future removal from Safari.
WebView Android No support NoChrome Android No support NoEdge Mobile No support NoFirefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android No support No

Legend

Full support  
Full support
No support  
No support
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.
Deprecated. Not for use in new websites.
Deprecated. Not for use in new websites.
See implementation notes.
See implementation notes.

See also

Document Tags and Contributors

Tags: 
Contributors to this page: lucian95, chrisdavidmills, teoli, cvrebert, jpmedley, fscholz, dhodder, jain.arpit.r, Rugby, kohei.yoshino, iamanupmenon, ethertank, Sheppy, Neil, George3, Mgjbot
Last updated by: lucian95,