DIV CSS 佈局教程網

window.showModalDialog 回傳值的取得與常見問題
編輯:JavaScript綜合知識     

模態對話框最有價值的地方,是它能同步回傳結果給父視窗。本文從基本用法談到回傳值的取得,再整理幾個實務上一定會遇到的問題。

基本用法

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 — 可選,字串,描述外觀,多項以分號隔開。

sFeatures 可用項目

  • dialogHeight:高度,不小於 100px。IE4 預設單位 em,IE5 起為 px,建議明確標示 px。
  • dialogWidth:寬度。
  • dialogLeft:離螢幕左側距離。
  • dialogTop:離螢幕上方距離。
  • center:{ yes | no | 1 | 0 } 是否置中,預設 yes。
  • help:{ yes | no | 1 | 0 } 是否顯示說明按鈕,預設 yes。
  • resizable:{ yes | no | 1 | 0 } [IE5+] 是否可調整大小,預設 no。
  • status:{ yes | no | 1 | 0 } [IE5+] 是否顯示狀態列,模態預設 no,非模態預設 yes。
  • scroll:{ yes | no | 1 | 0 | on | off } 是否顯示捲動條,預設 yes。

以下只用於 HTA:

  • dialogHide:列印或預覽時是否隱藏,預設 no。
  • edge:{ sunken | raised } 邊框樣式,預設 raised。
  • unadorned:{ yes | no | 1 | 0 | on | off } 預設 no。

傳值與回傳值

傳入參數

<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">,否則會彈出新視窗。

四、用 JavaScript 關閉對話框

<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 並關閉視窗,父視窗的呼叫這才返回並把值填入自己的欄位。

關於這套 API

必須再次提醒:showModalDialog 與 showModelessDialog 皆已從 Web 標準中移除,Chrome 自 2014 年起就不再支援,Firefox 也早已移除。上面所有技巧(包含 <base target="_self"> 這類 workaround)都只對 IE 有效。

若你在維護舊系統而必須保留這些程式碼,建議規劃遷移到 <dialog> 元素搭配 showModal(),並以 postMessage 取代直接跨視窗存取物件的做法。這樣不僅跨瀏覽器可用,也不必再依賴 <base> 這種副作用很多的迂迴技巧。

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