Window.showModalDialog()

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 AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
showModalDialog
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 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

Last modified:

, by MDN contributors
Related Topics
  1. Window
  2. Properties
    1. applicationCache
    2. caches
    3. closed
    4. console
    5. controllers
    6. crypto
    7. customElements
    8. defaultStatus
    9. devicePixelRatio
    10. dialogArguments
    11. directories
    12. document
    13. event
    14. frameElement
    15. frames
    16. fullScreen
    17. history
    18. indexedDB
    19. innerHeight
    20. innerWidth
    21. isSecureContext
    22. isSecureContext
    23. length
    24. localStorage
    25. location
    26. locationbar
    27. menubar
    28. mozAnimationStartTime
    29. mozInnerScreenX
    30. mozInnerScreenY
    31. mozPaintCount
    32. name
    33. navigator
    34. onabort
    35. onafterprint
    36. onanimationcancel
    37. onanimationend
    38. onanimationiteration
    39. onappinstalled
    40. onauxclick
    41. onbeforeinstallprompt
    42. onbeforeprint
    43. onbeforeunload
    44. onblur
    45. oncancel
    46. oncanplay
    47. oncanplaythrough
    48. onchange
    49. onclick
    50. onclose
    51. oncontextmenu
    52. oncuechange
    53. ondblclick
    54. ondevicelight
    55. ondevicemotion
    56. ondeviceorientation
    57. ondeviceorientationabsolute
    58. ondeviceproximity
    59. ondragdrop
    60. ondurationchange
    61. onended
    62. onerror
    63. onfocus
    64. ongamepadconnected
    65. ongamepaddisconnected
    66. ongotpointercapture
    67. onhashchange
    68. oninput
    69. oninvalid
    70. onkeydown
    71. onkeypress
    72. onkeyup
    73. onlanguagechange
    74. onload
    75. onloadeddata
    76. onloadedmetadata
    77. onloadend
    78. onloadstart
    79. onlostpointercapture
    80. onmessage
    81. onmessageerror
    82. onmousedown
    83. onmouseenter
    84. onmouseleave
    85. onmousemove
    86. onmouseout
    87. onmouseover
    88. onmouseup
    89. onmozbeforepaint
    90. onpaint
    91. onpause
    92. onplay
    93. onpointercancel
    94. onpointerdown
    95. onpointerenter
    96. onpointerleave
    97. onpointermove
    98. onpointerout
    99. onpointerover
    100. onpointerup
    101. onpopstate
    102. onrejectionhandled
    103. onreset
    104. onresize
    105. onscroll
    106. onselect
    107. onselectionchange
    108. onselectstart
    109. onstorage
    110. onsubmit
    111. ontouchcancel
    112. ontouchstart
    113. ontransitioncancel
    114. ontransitionend
    115. onunhandledrejection
    116. onunload
    117. onuserproximity
    118. onvrdisplayactivate
    119. onvrdisplayblur
    120. onvrdisplayconnect
    121. onvrdisplaydeactivate
    122. onvrdisplaydisconnect
    123. onvrdisplayfocus
    124. onvrdisplaypointerrestricted
    125. onvrdisplaypointerunrestricted
    126. onvrdisplaypresentchange
    127. onwheel
    128. opener
    129. origin
    130. outerHeight
    131. outerWidth
    132. pageXOffset
    133. pageYOffset
    134. parent
    135. performance
    136. personalbar
    137. pkcs11
    138. screen
    139. screenLeft
    140. screenTop
    141. screenX
    142. screenY
    143. scrollbars
    144. scrollMaxX
    145. scrollMaxY
    146. scrollX
    147. scrollY
    148. self
    149. sessionStorage
    150. sidebar
    151. speechSynthesis
    152. status
    153. statusbar
    154. toolbar
    155. top
    156. visualViewport
    157. window
  3. Methods
    1. alert()
    2. atob()
    3. back()
    4. blur()
    5. btoa()
    6. cancelAnimationFrame()
    7. cancelIdleCallback()
    8. captureEvents()
    9. clearImmediate()
    10. clearInterval()
    11. clearTimeout()
    12. close()
    13. confirm()
    14. convertPointFromNodeToPage()
    15. convertPointFromPageToNode
    16. createImageBitmap()
    17. dump()
    18. fetch()
    19. find()
    20. focus()
    21. forward()
    22. getAttention()
    23. getComputedStyle()
    24. getDefaultComputedStyle()
    25. getSelection()
    26. home()
    27. matchMedia()
    28. minimize()
    29. moveBy()
    30. moveTo()
    31. open()
    32. openDialog()
    33. postMessage()
    34. print()
    35. prompt()
    36. queueMicrotask()
    37. releaseEvents()
    38. requestAnimationFrame()
    39. requestFileSystem()
    40. requestIdleCallback()
    41. resizeBy()
    42. resizeTo()
    43. restore()
    44. routeEvent()
    45. scroll()
    46. scrollBy()
    47. scrollByLines()
    48. scrollByPages()
    49. scrollTo()
    50. setCursor()
    51. setImmediate()
    52. setInterval()
    53. setTimeout()
    54. showModalDialog()
    55. sizeToContent()
    56. stop()
    57. updateCommands()
  4. Events
    1. event
    2. afterprint
    3. beforeprint
    4. beforeunload
    5. blur
    6. copy
    7. cut
    8. DOMContentLoaded
    9. error
    10. focus
    11. hashchange
    12. languagechange
    13. load
    14. message
    15. messageerror
    16. offline
    17. online
    18. orientationchange
    19. pagehide
    20. pageshow
    21. paste
    22. popstate
    23. rejectionhandled
    24. storage
    25. unhandledrejection
    26. unload
    27. vrdisplayconnect
    28. vrdisplaydisconnect
    29. vrdisplaypresentchange