showModalDialog 是 IE 專有 API,用於創建模態對話框(阻塞父頁面交互)。雖已被標準廢棄(Chrome 37+、Firefox、Edge 均移除),但在老項目維護、內網 IE 模式下仍有遇到。本文詳細記錄參數用法、數據傳遞、常見坑點與現代替代方案。
var returnVal = window.showModalDialog(sURL[, vArguments][, sFeatures]);
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
| sURL | String | 是 | 對話框加載頁面 URL |
| vArguments | Variant | 否 | 傳遞給對話框的任意數據(對象、數組、函數均可),子頁通過 window.dialogArguments 獲取 |
| sFeatures | String | 否 | 窗口外觀參數,分號分隔,見下表 |
| 屬性 | 值範圍 | 默認 | 說明 |
|---|---|---|---|
| dialogWidth | 像素/em | - | 對話框寬度,最小 100px |
| dialogHeight | 像素/em | - | 對話框高度,最小 100px |
| dialogLeft | 像素 | 居中 | 距屏幕左邊距 |
| dialogTop | 像素 | 居中 | 距屏幕上邊距 |
| center | yes/no/1/0 | yes | 是否居中顯示 |
| resizable | yes/no/1/0 | no | 是否可調整大小 |
| status | yes/no/1/0 | no | 是否顯示狀態欄 |
| scroll | yes/no/on/off | yes | 是否顯示滾動條 |
| help | yes/no/1/0 | yes | 是否顯示幫助按鈕(IE4) |
// 父頁
var result = window.showModalDialog('child.html', '初始參數', 'dialogWidth:400px;dialogHeight:300px');
console.log('返回:', result);
// 子頁
window.returnValue = '處理結果'; // 設置返回值
window.close(); // 關閉並返回
// 父頁
var sharedData = { userId: 1001, name: '張三', callback: function(msg) { alert(msg); } };
window.showModalDialog('child.html', sharedData, 'dialogWidth:500px;dialogHeight:400px');
console.log('子頁修改後:', sharedData.name); // 直接讀取被修改的屬性
// 子頁
var args = window.dialogArguments; // 獲取父頁傳入的對象引用
args.name = '李四'; // 直接修改父頁對象
args.callback('來自子頁的消息'); // 調用父頁函數
核心優勢:傳遞 window 或共享對象引用,實現雙向通信,不依賴返回值。
<base target="_self"> 強制本窗口跳轉。location.reload()。base target="_self",否則 window.close() 可能打開新標籤再關閉。sessionStorage 中轉。<dialog> 元素(HTML5.2 標準)<dialog id="myDialog">
<form method="dialog">
<p>內容</p>
<button value="confirm">確定</button>
<button value="cancel">取消</button>
</form>
</dialog>
<script>
const dialog = document.getElementById('myDialog');
dialog.showModal(); // 模態
dialog.addEventListener('close', () => console.log(dialog.returnValue));
</script>
// Bootstrap 5 示例
const modal = new bootstrap.Modal('#myModal');
modal.show();
// 返回值處理:用 Promise 封裝
function showConfirm(message) {
return new Promise(resolve => {
$('#confirmMsg').text(message);
$('#confirmModal').modal('show');
$('#confirmBtn').one('click', () => { modal.hide(); resolve(true); });
$('#cancelBtn').one('click', () => { modal.hide(); resolve(false); });
});
}
// 使用
const ok = await showConfirm('確定刪除?');
if (ok) { /* ... */ }
showModalDialog 是 IE 時代產物,新項目嚴禁使用。老項目維護時採用「對象引用傳遞」模式減少耦合,並同步規劃遷移至 <dialog> 或組件庫 Modal。核心思想:模態阻塞交互、雙向數據通信、生命週期可控。