DIV CSS 佈局教程網

window.showModalDialog() 用法與返回值完整整理(含 HTA 專屬參數)
編輯:關於JavaScript     

先提醒:showModalDialog 是 IE 專屬功能,已在 Chrome、Firefox 中被移除,微軟也曾標示為 deprecated。以下內容適用於維護舊的 IE 系統。

基本用法

showModalDialog()   // IE 4+ 支援
showModelessDialog() // IE 5+ 支援

window.showModalDialog() 建立一個顯示 HTML 內容的模態對話框;window.showModelessDialog() 建立非模態對話框。

vReturnValue = window.showModalDialog(sURL [, vArguments] [, sFeatures])
vReturnValue = window.showModelessDialog(sURL [, vArguments] [, sFeatures])

參數說明

sURL(必選,字串):對話框要載入的文件的 URL。

vArguments(可選,變體):傳給對話框的參數,型別不限,包含陣列、物件。對話框內用 window.dialogArguments 取得。

sFeatures(可選,字串):描述對話框外觀,可用一或多個,以分號隔開。

  1. dialogHeight:對話框高度,不小於 100px。IE4 中單位預設是 em,IE5 起為 px,建議明確寫 px。
  2. dialogWidth:對話框寬度。
  3. dialogLeft:距螢幕左側的距離。
  4. dialogTop:距螢幕上方的距離。
  5. center:{yes | no | 1 | 0} 是否居中,預設 yes,仍可指定高寬。
  6. help:{yes | no | 1 | 0} 是否顯示說明按鈕,預設 yes。
  7. resizable:{yes | no | 1 | 0}(IE5+)是否可改變大小,預設 no。
  8. status:{yes | no | 1 | 0}(IE5+)是否顯示狀態列,模態預設 no,非模態預設 yes。
  9. scroll:{yes | no | 1 | 0 | on | off} 是否顯示捲軸,預設 yes。

以下三個僅用於 HTA,一般網頁不會用到:

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

參數傳遞

向對話框傳參,透過 vArguments。字串最大 4096 字元,也可傳物件:

<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>

向父視窗回傳值,用 window.returnValue,可以是物件:

<script>
str = window.showModalDialog("test.htm",, "dialogWidth=200px;dialogHeight=100px");
alert(str);
</script>
<!-- test.htm -->
<script>
window.returnValue = "/";
</script>

一、兩者的差異

showModalDialog:開啟後始終保持輸入焦點,除非關閉對話框,否則使用者無法切換回主視窗,效果類似 alert。

showModelessDialog:開啟後使用者可自由切換焦點,對主視窗沒有阻斷作用。

二、讓超連結不在新視窗開啟

在被開啟的網頁中加入 <base target="_self"> 即可,這句話一般放在 <html> 與 <body> 之間(實務上應放 <head> 內)。

三、重新整理對話框內容

對話框內按 F5 無法重新整理,也不能叫出右鍵選單,只能靠 JavaScript:

<body onkeydown="if (event.keyCode==116){reload.click()}">
<a id="reload" href="filename.htm" style="display:none">reload...</a>

把 filename.htm 換成實際檔名。這段必須搭配 <base target="_self"> 使用,否則按 F5 會另開新視窗。

四、關閉對話框

<input type="button" value="關閉" onclick="window.close()">

同樣要配合 <base target="_self">,否則會先開一個新的 IE 視窗再關掉。

五、資料傳遞技巧(重點)

要讀寫對話框中的變數 var_name:

一般傳遞方式

window.showModalDialog("filename.htm", var_name); // 傳遞 var_name

// 在對話框中讀取與設定
alert(window.dialogArguments); // 讀取
window.dialogArguments = "oyiboy"; // 設定

這種寫法看似可行,但局限在只能操作一個變數。若還要同時操作 var_id,就無法繼續了。

建議的傳遞方式:直接傳 window 物件

window.showModalDialog("filename.htm", window); // 傳主視窗的 window 物件

// 在對話框中讀取與設定
alert(window.dialogArguments.var_name); // 讀取 var_name
window.dialogArguments.var_name = "oyiboy"; // 設定 var_name

// 同時也能操作 var_id
alert(window.dialogArguments.var_id);
window.dialogArguments.var_id = "001";

// 還可操作主視窗的任何物件,例如表單元素
window.dialogArguments.form1.index1.value = "這是在設定 index1 元素的值";

傳整個 window 物件的好處是:對話框能直接存食宿主頁面的狀態,關閉後主頁面立刻看到變更,不需要再靠返回值搬資料。

六、父頁面完整互動範例

// 父頁面
onClick="var reVal = window.showModalDialog('changephoto.htm','','dialogWidth:500px;dialogHeight:300px;help:no');
if (typeof(reVal) != 'undefined') { form.textname.value = reVal; }"
style="cursor:hand">點擊這裡修改圖片

子視窗 changephoto.htm 中開一個框架集,框架內含一個 asp 檔;先把 asp 的值回傳到 changephoto.htm,再回傳給主頁面。

<!-- 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 = "值或變數";

現代替代方案

跨瀏覽器的模態對話框請改用:

  • <dialog> 元素搭配 showModal():原生、可樣式化、支援 Esc 關閉與焦點鎖定。
  • window.alert(message):需要回傳值的簡單確認場景。
  • 需要「對話框回傳值」的模式:用 <dialog> 搭配 dialog.returnValue,或以 postMessage 與 iframe 溝通,並用 Promise 包裝成非同步 API。

另外提醒:原範例中 dialogWidth:500px 用了冒號,正確分隔方式是等號(dialogWidth=500px),否則該設定不會生效。

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