ShowModalDialog
是 JavaScript 中的一个对话框函数,用于打开一个新的浏览器窗口,显示指定的内容,并阻止用户与当前页面的交互,直到该对话框被关闭。ShowModalDialog
函数接受两个参数:
-
URL(必需):要显示在新窗口中的文档的 URL。这个 URL 可以是一个绝对路径或相对路径,指向一个 HTML 文件或其他可显示的文档。
-
options(可选):一个包含对话框设置的 JavaScript 对象。这个对象可以包含以下属性:
- width(整数):新窗口的宽度,以像素为单位。默认值为 500。
- height(整数):新窗口的高度,以像素为单位。默认值为 300。
- left(整数):新窗口距离屏幕左侧的距离,以像素为单位。默认值为 200。
- top(整数):新窗口距离屏幕顶部的距离,以像素为单位。默认值为 200。
- scrollbars(布尔值):是否在新窗口中显示滚动条。默认值为
true
。 - status(布尔值):是否在新窗口的标题栏中显示状态栏。默认值为
true
。 - resizable(布尔值):是否允许用户调整新窗口的大小。默认值为
true
。 - alwaysRaised(布尔值):当新窗口被打开时,是否始终将其置于其他窗口的顶部。默认值为
false
。 - dependent(布尔值):是否使新窗口依赖于父窗口。默认值为
false
。 - center(布尔值):是否将新窗口居中显示。默认值为
false
。 - dialogWidth 和 dialogHeight:与
width
和height
类似,但用于指定对话框的宽度和高度,而不是整个窗口。 - unloaded:一个回调函数,当新窗口加载完成时触发。
- beforeunload:一个回调函数,当新窗口即将卸载时触发。
- close:一个回调函数,当用户关闭新窗口时触发。
示例用法:
window.showModalDialog("https://example.com", "Dialog Title", { width: 800, height: 600, left: 100, top: 100, scrollbars: true, resizable: false });
在这个示例中,将打开一个新的浏览器窗口,显示 https://example.com
的内容,并具有指定的宽度、高度和其他设置。