`window.showModalDialog()` 是一个在早期Web开发中常用的JavaScript函数，用于打开一个模态对话框，即在对话框打开期间，用户无法与对话框之外的任何页面元素交互。这个函数在IE4及以上版本的Internet Explorer中得到支持，但在其他浏览器如Firefox、Chrome等中，它的行为可能不一致或者被废弃。
### `window.showModalDialog()` 的基本用法
调用语法如下：
```javascript
var returnValue = window.showModalDialog(sURL, vArguments, sFeatures);
```
- `sURL`：必需参数，字符串类型，指定对话框要显示的HTML内容的URL。
- `vArguments`：可选参数，可以是任意类型，用于向对话框传递参数，对话框内部可以通过 `window.dialogArguments` 访问这些参数。
- `sFeatures`：可选参数，字符串类型，包含对话框的各种设置，如高度、宽度、位置、是否可调整大小、是否有滚动条等。
### 参数设置
`sFeatures` 参数中的各种选项，如 `dialogHeight`、`dialogWidth`、`center`、`help`、`resizable`、`status`、`scroll` 等，用于定制对话框的外观和行为。例如：
```javascript
window.showModalDialog('dialog.html', null, 'dialogHeight:300px;dialogWidth:400px;center:1');
```
这将打开一个高度为300像素，宽度为400像素，并且居中的模态对话框。
### 参数传递
1. 使用 `vArguments` 传递参数，可以是字符串、对象等，如：
```javascript
var obj = {name: "John"};
window.showModalDialog('dialog.html', obj, 'dialogWidth=200px;dialogHeight=100px');
```
2. 对话框通过 `window.dialogArguments` 获取传递的参数。
### 返回值
`window.showModalDialog()` 的返回值（`returnValue`）可以用于向打开对话框的窗口返回信息。当对话框关闭时，它会返回一个值，可以是任何类型，包括字符串、数字或对象。例如：
```javascript
var result = window.showModalDialog('dialog.html');
```
在对话框内部设置返回值：
```javascript
window.returnValue = 'Some value';
```
### `window.showModalDialog()` 与 `window.showModelessDialog()` 的区别
- `showModalDialog()`：打开的对话框是模态的，用户必须先关闭对话框才能继续与主窗口交互，类似于 `alert()` 或 `confirm()` 对话框。
- `showModelessDialog()`：打开的对话框是非模态的，用户可以在对话框打开的同时与主窗口进行交互。这种方式更像一个浮动窗口或面板。
需要注意的是，由于现代浏览器对 `showModalDialog()` 的兼容性和支持度不高，以及有更现代的替代方案（如Bootstrap的模态框、jQuery UI对话框等），在新的Web开发项目中，`showModalDialog()` 已经较少被使用。开发者通常转向使用更标准、跨浏览器的解决方案来实现类似功能。
