showModalDialog 與 showModelessDialog 是 IE 專有的對話框 API,能開啟一個「網頁形式的視窗」。它們在當年被大量用於後台管理介面,如今已被標準淘汰,但理解它能釐清許多相關概念。
showModalDialog(強制模式):開啟後會持續保持輸入焦點,除非關閉對話框,否則使用者無法切回主視窗,效果類似 alert。
showModelessDialog(非強制模式):開啟後使用者可以自由切換焦點,對主視窗沒有阻斷作用,最多少遮到一點畫面。
在被開啟的網頁中加上:
<base target="_self" />
這行通常放在 <head> 之間。它的作用是改變頁面上所有連結的預設 target,讓點擊時在目前視窗內跳轉,而不是開一個新的瀏覽器視窗。
在 showModalDialog 開啟的視窗裡按 F5 不會重新整理,也無法叫出右鍵選單。只能靠 script:
<body onkeydown="if (event.keyCode==116){reload.click()}">
<a id="reload" href="filename.htm" style="display:none">reload...</a>
</body>
把 filename.htm 換成實際頁名。這裡的技巧是:先用 onkeydown 攔下 F5(鍵碼 116),再觸發一個隱藏連結的 click,讓瀏覽器走一次正常的跳轉流程。注意這必須配合 <base target="_self">,否則按 F5 會彈出一個新視窗。
<input type="button" value="關閉" onclick="window.close()" />
同樣要配合 <base target="_self">,否則會先開一個新的 IE 視窗再把它關掉。
這部分最容易出問題。一般的傳遞方式是:
// 主視窗
window.showModalDialog("filename.htm", var_name); // 傳入變數
// 對話框內
alert(window.dialogArguments); // 讀取
window.dialogArguments = "oyiboy"; // 設定
這種方式在只操作一個變數時勉強可用,但當你想同時操作第二個變數 var_id 時就無能為力了——因為 dialogArguments 只承載了一個值。
建議的傳遞方式是直接傳整個 window 物件:
// 主視窗
window.showModalDialog("filename.htm", window);
// 對話框內:讀取與設定
alert(window.dialogArguments.var_name);
window.dialogArguments.var_name = "oyiboy";
alert(window.dialogArguments.var_id);
window.dialogArguments.var_id = "001";
// 甚至能操作主視窗上的表單元素
window.dialogArguments.form1.index1.value = "這是在設定 index1 元素的值";
傳 window 的好處是對話框取得了主視窗的完整參照,任何變數、任何 DOM 節點都能操作,不必為了多傳一個值而反覆改寫呼叫端。代價是耦合變強——對話框知道太多主視窗的細節,維護時牽一髮動全身。
因為是強制模式,主視窗與對話框之間必須透過 dialogArguments 才能溝通。以下示範用一個非強制視窗去控制另一個非強制視窗的位置。
// 主視窗:開啟兩個非強制對話框
var s1 = showModelessDialog('控制.htm', window, "dialogTop:1px;dialogLeft:1px");
var s2 = showModelessDialog('about:blank', window, "dialogTop:200px;dialogLeft:300px");
關鍵是把兩個視窗物件存進變數(s1、s2),這樣主視窗就握有它們的參照。而在 控制.htm 中,可以透過 window.dialogArguments.s2 反過來取得被控制的那個視窗。
<script>
// 視窗位置是 "xxxpx" 的字串形式,需要特殊處理
function countNumber(A_strNumber, A_strWhatdo) {
A_strNumber = A_strNumber.replace('px', '');
A_strNumber -= 0;
switch (A_strWhatdo) {
case "-": A_strNumber -= 10; break;
case "+": A_strNumber += 10; break;
}
return A_strNumber + "px";
}
</script>
<input type="button" value="上移"
onclick="window.dialogArguments.s2.dialogTop = countNumber(window.dialogArguments.s2.dialogTop, '-')">
<input type="button" value="下移"
onclick="window.dialogArguments.s2.dialogTop = countNumber(window.dialogArguments.s2.dialogTop, '+')">
<input type="button" value="左移"
onclick="window.dialogArguments.s2.dialogLeft = countNumber(window.dialogArguments.s2.dialogLeft, '-')">
<input type="button" value="右移"
onclick="window.dialogArguments.s2.dialogLeft = countNumber(window.dialogArguments.s2.dialogLeft, '+')">
這個例子的關鍵有兩個:視窗的命名方式(var s1 = showModelessDialog(...)),以及變數的存取路徑(window.dialogArguments.s2.dialogTop)。掌握這兩點,就能在多個非強制視窗之間互相控制顯示頁面、傳遞變數與資料。
若開啟了一個強制視窗,想在關閉自己的同時重新載入父視窗:
<script language="javascript">
parent.window.opener = null;
parent.window.dialogArguments.location.reload();
window.close();
</script>
或者更簡潔地在主視窗處理:
function doModal(url) {
window.showModalDialog(url, 0, "dialogWidth:500px;dialogHeight:500px;status:no;help:no;");
document.location.reload(); // 對話框關閉後才會走到這裡
}
這裡有個重要行為要理解:showModalDialog 是同步阻塞的——下一行程式碼會等對話框關閉後才執行。這正是它能用來「取得使用者輸入後繼續」的原因,也是它最大的問題:整個瀏覽器分頁會完全凍結。
必須明確說明:showModalDialog 在 2007 年由 HTML5 標準提案,但 Chrome 與 Firefox 從未實作,微軟也在 Edge 改版後移除了它。它現在只存在於 IE,而 IE 已停止支援。
更重要的是,這個 API 本質上就有設計缺陷。它是同步阻塞的,會凍結整個渲染與事件迴圈;它開啟的是真正的作業系統視窗,位置與樣式都受限;IE 實作還要求視窗必須由使用者操作觸發,並有 URL 白名單限制,稍一不符就靜默失敗。這些限制並非偶然,而是瀏覽器廠商共同得出的結論:網頁不該擁有「凍結使用者整個瀏覽器」的能力。
現代的標準答案是 <dialog> 元素搭配 showModal()。它同樣會產生強制模式的行為(隔絕背景互動、 implicitly 讓其他內容 inert),但完全是非同步的,不會凍結頁面:
<dialog id="dlg">
<form method="dialog">
<label>輸入:<input id="childTextBox" /></label>
<button value="ok">確定</button>
</form>
</dialog>
<script>
var dlg = document.getElementById('dlg');
dlg.showModal();
dlg.addEventListener('close', function () {
var value = document.getElementById('childTextBox').value;
document.getElementById('parentTextBox').value = value; // 傳回父層
});</script>
資料傳遞也不再需要 dialogArguments 這種尷尬機制:關閉時把值寫進 returnValue,或直接從 DOM 讀取即可。若要在 iframe 與父視窗之間溝通,標準做法是 postMessage,它天生跨來源安全,也不必讓子視窗持有父視窗的完整參照。
理解 showModalDialog 的價值,在於它清楚示範了「強制模式對話框」需要處理哪些問題:焦點鎖定、資料雙向傳遞、多視窗協調、關閉後的善後。这些问题在 <dialog> 裡依然存在,只是標準把它們處理得更安全、更非同步、也更少踩坑。