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
returnValis a variant, indicating the returnValue property as set by the window of the document specified byuri.uriis the URI of the document to display in the dialog box.argumentsis an optional variant that contains values that should be passed to the dialog box; these are made available in thewindowobject'swindow.dialogArgumentsproperty.optionsan 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
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
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
| Desktop | Mobile | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | Android webview | Chrome for Android | Edge Mobile | Firefox for Android | Opera for Android | iOS Safari | Samsung Internet | |
| Basic support | Chrome No support ? — 43 | Edge No support No | Firefox No support 3 — 56 | IE Full support 4 | Opera No support No | Safari
Full support
5.1
| WebView Android No support No | Chrome Android No support No | Edge Mobile No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung 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
<dialog>, a replacement forwindow.showModalDialog().- showModalDialog Polyfill using a
<dialog>and generators
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,