有一類互動需求是:點擊按鈕開啟一個編輯視窗,在這個視窗關閉之前,背後的父頁面不該被操作。與其手動加上遮罩層並攔截所有點擊,用 showModalDialog 一個方法就能做到。
function onNewClick()
{
var url = "VesselScheduleNEW.aspx";
if (null != newWin && newWin.closed) newWin = null;
if (null == newWin)
newWin = window.showModalDialog(
url, "newwin",
"dialogWidth=1000px;dialogHeight=400px;help:no;center:yes;resizable:no;status:no;scroll:no"
);
if (newWin == "OK")
{
window.location.reload();
}
}
showModalDialog 會開啟一個強制模式(modal)對話框,在關閉之前,父頁面的滑鼠與鍵盤操作都會被瀏覽器攔住,這正是我們要的「父頁面 DISABLE、子頁面關閉後恢復 ENABLE」效果。
它的第三個參數是一串以分號分隔的設定:對話框寬高、置中、是否可縮放、是否顯示工具列與狀態列等。
還有一個關鍵特性:這個方法會回傳值。子視窗只要設定 window.returnValue = "OK" 再關閉,父頁面就能拿到這個值並據此決定要不要刷新。程式中 newWin == "OK" 的判斷就是這個用途——使用者存檔成功才回傳 OK,父頁面才 reload;若只是取消關閉,畫面就不動。
開頭那兩行 closed 判斷則是為了避免重複開窗,並在視窗已被使用者關掉時把參照清乾淨。
這個 API 最早由 IE 提出,Chrome 與 Safari 也曾實作,但已被標準移除,Firefox 從未支援。也就是說,今天寫這個程式在多數環境下會拿到「不是函式」的錯誤。
現代對應的做法有三種:
// 1. window.open 搭配 opener 溝通(仍為獨立視窗,但非強制模態)
var w = window.open("edit.aspx", "newwin", "width=1000,height=400");
// 2. 用
<dialog> 是最接近原意的標準方案:showModal() 會自動產生遮罩並阻斷背景互動,returnValue 的設計也延續了下來,可以用 close("OK") 回傳值。若需要相容舊瀏覽器,再搭配 dialog-polyfill 即可。