Window: showModalDialog() 方法

已弃用: 此功能不再推荐使用。尽管某些浏览器可能仍然支持它,但它可能已从相关的 Web 标准中删除,可能正在被删除,或者可能仅出于兼容性目的而保留。避免使用它,并在可能的情况下更新现有代码;请参阅此页面底部的兼容性表格以指导您的决策。请注意,此功能可能随时停止工作。

非标准: 此功能是非标准的,并且不在标准轨道上。不要在面向 Web 的生产站点上使用它:它不会对每个用户都起作用。实现之间也可能存在很大的不兼容性,并且行为将来可能会发生变化。

警告: 此功能已被删除。请修复您的网站和应用程序。

此方法已在 Chrome 43 和 Firefox 56 中删除。

Window.showModalDialog() 创建并显示了一个包含指定 HTML 文档的模态对话框。

语法

js
showModalDialog(uri)
showModalDialog(uri, arguments)
showModalDialog(uri, arguments, options)

参数

uri

是要在对话框中显示的文档的 URL。

arguments 可选

传递给对话框的属性的值。

options 可选

一个字符串,使用一个或多个分号分隔的值来指定对话框的窗口装饰。

语法 描述
center: {on | off | yes | no | 1 | 0 } 如果为 onyes1,则对话框窗口将居中显示在桌面上;否则将隐藏。默认值为 yes
dialogheight: height 对话框的高度(以像素为单位)。
dialogleft: left 对话框距离桌面左侧边缘的距离。
dialogwidth: width 对话框的宽度(以像素为单位)。
dialogtop: top 对话框距离桌面顶部边缘的距离。
resizable: {on | off | yes | no | 1 | 0 } 如果此参数的值为 onyes 或 1,则用户可以调整对话框窗口的大小;否则其大小是固定的。默认值为 no
scroll: {on | off | yes | no | 1 | 0 } 如果为 onyes 或 1,则对话框窗口具有滚动条;否则其大小是固定的。默认值为 no

注意: Firefox 未实现 dialogHideedgestatusunadorned 参数。

返回值

保存由 uri 指定的文档设置的 returnValue 属性。

规范

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅