模態對話框最有價值的地方,是它能同步回傳結果給父視窗。本文從基本用法談到回傳值的取得,再整理幾個實務上一定會遇到的問題。
showModalDialog() // IE 4+ 支援
showModelessDialog() // IE 5+ 支援
window.showModalDialog() // 建立模態對話框
window.showModelessDialog() // 建立非模態對話框
vReturnValue = window.showModalDialog(sURL [, vArguments] [, sFeatures])
vReturnValue = window.showModelessDialog(sURL [, vArguments] [, sFeatures])
sURL — 必選,字串,對話框要顯示的文件 URL。
vArguments — 可選,變體,向對話框傳遞的參數,型別不限,對話框以 window.dialogArguments 接收。
sFeatures — 可選,字串,描述外觀,多項以分號隔開。
以下只用於 HTA:
<script>
var obj = new Object();
obj.name = "ttop";
window.showModalDialog("test.htm", obj, "dialogWidth=200px;dialogHeight=100px");
</script>
<!-- test.htm -->
<script>
var obj = window.dialogArguments;
alert("您傳遞的參數為:" + obj.name);
</script>
<script>
str = window.showModalDialog("test.htm", , "dialogWidth=200px;dialogHeight=100px");
alert(str);
</script>
<!-- test.htm -->
<script>
window.returnValue = "/";
</script>
子視窗把值寫進 window.returnValue 後關閉,父視窗的 showModalDialog 呼叫才會返回,此時 str 就取得了該值。
showModalDialog:開啟後會始終保持輸入焦點,除非對話框關閉,否則使用者無法切換到主視窗。效果類似 alert。
showModelessDialog:開啟後使用者可以自由切換焦點,對主視窗沒有實質影響(最多少遮住一部分)。
在被打開的網頁中加入:
<base target="_self">
這行一般放在 <html> 與 <body> 之間。少了它,對話框內點連結會另開一個新的 IE 視窗。
對話框中按 F5 沒有用,也無法叫出右鍵選單,只能靠 JavaScript:
<body onkeydown="if (event.keyCode==116){reload.click()}">
<a id="reload" href="filename.htm" style="display:none">reload...</a>
把 filename.htm 換成實際的檔名。F5 的 keyCode 是 116,按下時程式會觸發那個隱藏連結的點擊,達到重新載入的效果。這段仍然要搭配 <base target="_self">,否則會彈出新視窗。
<input type="button" value="關閉" onclick="window.close()">
同樣要配合 <base target="_self">,否則會先開啟一個新視窗再把它關掉。
一般寫法是直接傳單一變數:
window.showModalDialog("filename.htm", var_name) // 傳遞 var_name
// 在對話框中讀取與設定
alert(window.dialogArguments) // 讀取
window.dialogArguments = "oyiboy" // 設定
這種方式有個明顯局限:一旦你想同時操作第二個變數 var_id,就無能為力了。
建議的做法是傳整個 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 元素的值";
父頁面:
<a onClick="var reVal = window.showModalDialog('changephoto.htm',
'dialogWidth:500px;dialogHeight:300px;help:no');
if (typeof(reVal) != 'undefined') { form.textname.value = reVal; }"
style="cursor:hand">點擊這裡修改圖片</a>
子視窗 changephoto.htm:
<input type="button" onclick="onClose();" value=" 關 閉 ">
<script>
function onClose() {
window.returnValue = form1.save.value;
// 也可以寫成 window.dialogArguments.oblogform.blogimage.value
window.close();
}
</script>
其中的 ASP 檔案:
parent.document.form1.save.value = "值或變數";
整體流程是:子視窗內嵌一個框架集,框架集中的 ASP 檔先把值寫回 changephoto.htm 的表單欄位,按下關閉時再把該值設為 returnValue 並關閉視窗,父視窗的呼叫這才返回並把值填入自己的欄位。
必須再次提醒:showModalDialog 與 showModelessDialog 皆已從 Web 標準中移除,Chrome 自 2014 年起就不再支援,Firefox 也早已移除。上面所有技巧(包含 <base target="_self"> 這類 workaround)都只對 IE 有效。
若你在維護舊系統而必須保留這些程式碼,建議規劃遷移到 <dialog> 元素搭配 showModal(),並以 postMessage 取代直接跨視窗存取物件的做法。這樣不僅跨瀏覽器可用,也不必再依賴 <base> 這種副作用很多的迂迴技巧。