window方法:showModalDialog()
showModalDialog()方法
Window.showModalDialog()创建并且显示包含指定HTML文档的模式对话框。
注意:showModalDialog()方法已过时,虽然它可能仍然适用于某些浏览器,但不鼓励使用它,因为它可以随时删除,尽量避免使用它,此方法已在Chrome 43和Firefox 56中删除。
showModalDialog()方法语法
returnVal = window.showModalDialog(uri [,arguments ] [,options ]);
其中:
- returnVal是一个变量,指示由uri指定的文档的窗口设置的returnValue属性。
- uri是要在对话框中显示的文档的URI。
- arguments是一个可选变量,包含应传递给对话框的值;这些在window对象的window.dialogArguments属性中可用。
- options是一个可选字符串,使用一个或多个以分号分隔的值指定对话框的窗口装饰:
句法 | 描述 |
---|---|
center: {on | off | yes | no | 1 | 0 } | 如果这个参数的值是on,yes或1,对话窗口集中在桌面上;否则它是隐藏的。默认值为yes。 |
dialogheight: height | 指定对话框的高度;默认情况下,大小以像素为单位指定。 |
dialogleft: left | 指定对话框相对于桌面左上角的水平位置。 |
dialogwidth: width | 指定对话框的宽度;默认情况下,大小以像素为单位指定。 |
dialogtop: top | 指定对话框相对于桌面左上角的垂直位置。 |
resizable: {on | off | yes | no | 1 | 0 } | 如果该参数的值是on,yes,或1,对话窗口可以由用户调整;否则它的大小是固定的。默认值为no。 |
scroll: {on | off | yes | no | 1 | 0 } | 如果这个参数的值on,yes或1,对话窗口有滚动条;否则它的大小是固定的。默认值为no。 |
注意:Firefox不支持dialogHide,edge,status,或unadorned参数。
笔记
showModalDialog()目前正在标准化为HTML5的一部分。第三个参数(对于其他选项)在HTML5版本中不存在,并且被Safari和Chrome忽略。
规范
- MSDN:showModalDialog方法
- 使用单独的文档实现HTML5对话框
浏览器兼容性
电脑端 | 移动端 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome
|
Edge
|
Firefox
|
Internet Explorer
|
Opera
|
Safari
|
Android webview | Chrome for Android
|
Edge Mobile | Firefox for Android
|
Opera for Android
|
iOS Safari | |
基本支持
(弃用)
|
不支持 | 不支持 | 不支持 | 支持:4 | 不支持 | 支持 | 不支持 | 不支持 | 不支持 | 不支持 | 不支持 | 不支持 |