DIV CSS 佈局教程網

showModalDialog 父子視窗傳值完整教學與常見問題
編輯:JavaScript綜合知識     

模態對話框最實用的地方在於「父子視窗雙向傳值」:父視窗把參數送進去,子視窗處理完再把結果送回來。這篇從最小範例出發,逐層說明傳值機制與常見疑問。

最小可運作範例

父視窗開啟對話框,等待回傳值後寫進輸入框:

<!-- 父視窗 -->
<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,就能得到一致且可維護的實作。

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