模態對話框最實用的地方在於「父子視窗雙向傳值」:父視窗把參數送進去,子視窗處理完再把結果送回來。這篇從最小範例出發,逐層說明傳值機制與常見疑問。
父視窗開啟對話框,等待回傳值後寫進輸入框:
<!-- 父視窗 -->
<script language="javascript" type="text/javascript">
function opendialog1() {
var someValue = window.showModalDialog("b.html", "",
"dialogWidth=500px;dialogHeight=500px;status=no;help=no;scrollbars=no");
document.form1.p1t.value = someValue;
}
</script>
<form name="form1" action="#">
<input type="text" name="p1t">
<input type="button" value="打開對話框" onclick="opendialog1()">
</form>
<!-- 子視窗 -->
<script language="javascript" type="text/javascript">
function a() {
var wname = document.form1.backname.value;
parent.window.returnValue = wname; // 回傳給父視窗
window.close();
}
</script>
<form name="form1" action="">
<input type="text" value="輸入要傳的值" name="backname">
<input type="button" value="傳值" onclick="return a()">
</form>
1. 只傳一個值——直接放在第二個參數:
var cSearchValue = showModalDialog('dialog.htm', 'ABC');
// 子視窗內用 window.dialogArguments 取得 'ABC'
<SCRIPT FOR="window" EVENT="onload" LANGUAGE="JScript">
if (window.dialogArguments != null)
document.all.iptPeopleID.value = window.dialogArguments;
</SCRIPT>
2. 傳多個值——先定義一個物件載入各項屬性,再把整個物件傳入:
function myDialog() {
var str1;
var str2;
}
function WelcomeYou(iniStr1, iniStr2) {
myDialog.str1 = iniStr1;
myDialog.str2 = iniStr2;
showModalDialog("dialog2.htm", myDialog); // 傳入物件
}
// 子視窗中取值
document.all.iptID.value = window.dialogArguments.str1;
// 子視窗中也可反向寫回
window.dialogArguments.str1 = document.all.iptID.value;
3. 傳陣列或 window 物件——型別完全不限制:
var mxh1 = new Array("mxh", "net_lover", "孟子E章");
window.showModalDialog("test2.htm", mxh1); // 傳陣列
var mxh2 = window.open("about:blank", "window_mxh");
window.showModalDialog("test3.htm", mxh2); // 傳 window 物件
// 回傳也可以是陣列
function sendTo() {
var a = new Array("a", "b");
window.returnValue = a;
window.close();
}
字串型參數若走 URL 傳遞,上限約為 4096 字元;但物件與陣列沒有這個限制,這也是推薦做法的原因。
IE 另外提供 showModelessDialog()(IE5+)。兩者的關鍵差異是:
模態(showModalDialog)的對話框永遠擁有焦點,關閉前無法操作父視窗,適合必須取得使用者回覆的流程。
非模態(showModelessDialog)則允許父視窗繼續操作,對話框不一定在最上層;當開啟它的視窗網址改變時,它會自動關閉。
Q:如何在模態對話框中送出表單而不另開視窗?
A:IE5.5+ 可在對話框內使用具 name 屬性的 iframe,並把表單的 target 指向該 iframe 名稱。IE4 則需用高度為 0 的 frame 搭配 target="_self" 的表單,藉此在同一視窗內完成提交與讀取 query string。
Q:可以用 test.htm?name=mxh 這種方式直接傳參數給對話框嗎?
A:對話框本身不支援這種寫法,但在 frame 內是可以的。
再次提醒:showModalDialog 已不在標準之中,僅舊版 IE 支援,Chrome 與 Opera 的行為並不正確。維護老系統時上述技巧仍然有用;若是新專案,請改用 <dialog> 搭配 showModal(),傳值改成 dialog.close(data) 或 Promise,就能得到一致且可維護的實作。