DIV CSS 佈局教程網

showModalDialog 使用指南:六個實務問題與解法
編輯:關於JavaScript     

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 會彈出一個新視窗。

四、如何用 JavaScript 關掉這個視窗

<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 節點都能操作,不必為了多傳一個值而反覆改寫呼叫端。代價是耦合變強——對話框知道太多主視窗的細節,維護時牽一髮動全身。

六、多個 showModelessDialog 互相操作

因為是強制模式,主視窗與對話框之間必須透過 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> 裡依然存在,只是標準把它們處理得更安全、更非同步、也更少踩坑。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved