window.showModalDialog()是JavaScript中的一个函数,用于打开一个模态对话框。
模态对话框是指在打开的对话框之前,用户无法与页面上其他部分进行交互。这与普通的对话框(非模态对话框)不同,普通对话框可以与页面上其他部分同时进行交互。
window.showModalDialog()函数的用法如下:
window.showModalDialog(url, [args], [options]);
参数说明:
- url:要打开的对话框的URL地址。
- args:可选参数,是一个对象,要传递给对话框的参数。可以在对话框中通过window.dialogArguments来获取这些参数。
- options:可选参数,是一个字符串,用于指定打开的对话框的各种选项。
options参数的常用选项有:
- "dialogWidth":指定对话框的宽度。
- "dialogHeight":指定对话框的高度。
- "dialogLeft":指定对话框距离屏幕左边的位置。
- "dialogTop":指定对话框距离屏幕上边的位置。
- "center":指定对话框是否居中显示。
示例代码:
```
var result = window.showModalDialog("dialog.html", {param1: "value1", param2: "value2"}, "dialogWidth:400px; dialogHeight:300px; center:yes");
```
在打开的对话框中,可以使用window.returnValue来设置对话框的返回值。示例代码如下:
```
window.returnValue = {result: "success"};
```
在打开的对话框中,可以通过window.dialogArguments来获取传递给对话框的参数。示例代码如下:
```
var param1 = window.dialogArguments.param1;
var param2 = window.dialogArguments.param2;
```
需要注意的是,window.showModalDialog()方法在现代浏览器中已经不再被支持。可以使用window.open()方法来代替。