作者：norika 整理日期：2004年6月17日 基本介绍： showModalDialog() (IE 4+ 支持) showModelessDialog() (IE 5+ 支持) window.showModalDialog()方法用来创建一个显示HTML内容的模态对话框。 window.showModelessDialog()方法用来创建一个显示HTML内容的非模态对话框。 使用方法： vReturnValue = window.showModalDialog(sURL [, vArguments] [,sFeatures]) vReturnValue = window.showMod
**Window.showModalDialog 使用手册**
`window.showModalDialog` 是Internet Explorer 4+ 版本开始支持的一个方法，用于创建一个模态对话框，显示HTML内容。模态对话框意味着用户必须关闭对话框才能继续与主窗口交互。相对地，`window.showModelessDialog` 创建的是非模态对话框，允许用户同时与对话框和主窗口进行交互，但这个方法仅在IE 5+中可用。
**方法签名：**
```javascript
vReturnValue = window.showModalDialog(sURL [, vArguments] [,sFeatures])
vReturnValue = window.showModelessDialog(sURL [, vArguments] [,sFeatures])
```
**参数详解：**
- **sURL**：必需参数，字符串类型。指定对话框要显示的文档的URL。可以是本地文件路径或远程URL。
- **vArguments**：可选参数，变体类型。向对话框传递参数，参数类型不受限制，包括数组、对象等。对话框通过 `window.dialogArguments` 来获取这些传递的参数。
- **sFeatures**：可选参数，字符串类型。用于定义对话框的外观和行为，如高度、宽度、位置、是否可调整大小、是否显示滚动条等。各特性之间用分号隔开。
- **dialogHeight**：对话框的高度，最小值为100px。在IE4中默认单位是em，IE5及以上版本是px。
- **dialogWidth**：对话框的宽度。
- **dialogLeft**：距离屏幕左侧的距离。
- **dialogTop**：距离屏幕顶部的距离。
- **center**：{yes | no | 1 | 0}，默认yes，即使设置了高度和宽度，也会尝试居中对话框。
- **help**：{yes | no | 1 | 0}，是否显示帮助按钮，默认yes。
- **resizable**：{yes | no | 1 | 0} [IE5+]，是否允许用户调整对话框大小，默认no。
- **status**：{yes | no | 1 | 0} [IE5+]，是否显示状态栏。对于模态对话框默认为no，非模态为yes。
- **scroll**：{ yes | no | 1 | 0 | on | off }，是否显示滚动条，默认为yes。
- **dialogHide**：{ yes | no | 1 | 0 | on | off } [用于HTA]，在打印或打印预览时是否隐藏对话框，默认no。
- **edge**：{ sunken | raised }，对话框边框样式，默认为raised。
- **unadorned**：{ yes | no | 1 | 0 | on | off }，默认为no，可能用于HTA中的特定场景。
**参数传递：**
1. **vArguments** 传递参数的方式非常灵活，可以是字符串、数字、对象等。例如，传递一个对象：
```javascript
// 主页面
var obj = new Object();
obj.name = "51js";
window.showModalDialog("modal.htm", obj, "dialogWidth=200px;dialogHeight=100px");
// 对话框页面
var obj = window.dialogArguments;
alert("您传递的参数为：" + obj.name);
```
2. **window.returnValue** 用于从对话框向调用它的窗口返回信息。返回值可以是任何类型，包括对象。例如：
```javascript
// 主页面
var str = window.showModalDialog("modal.htm", "", "dialogWidth=200px;dialogHeight=100px");
alert(str);
// 对话框页面
window.returnValue = "http://www.51js.com";
```
**应用场景：**
`window.showModalDialog` 常用于创建自定义的用户交互界面，如确认操作、输入信息、显示详细信息等，因为它可以阻止用户与主页面的其他部分交互，直到对话框关闭。在某些情况下，它也可以作为一个临时存储数据的容器，通过 `vArguments` 和 `window.returnValue` 进行数据交换。
需要注意的是，由于`showModalDialog`是IE特有方法，且在现代浏览器中不被广泛支持，开发跨平台应用时应谨慎使用，考虑使用替代方案，如JavaScript弹出层库（如jQuery UI Dialog）或HTML5的`<dialog>`元素。
