什麼是 showModalDialog?
showModalDialog 開啟的是一種模態視窗(modal window)。它的特性在於:視窗打開期間,父視窗會進入「暫停」狀態,使用者無法再去操作背後的父視窗,直到這個模態子視窗被關閉為止。
在傳統的 Ajax 開發場景裡,這個方法常被拿來做表單填寫、線上問答、資料挑選這類需要「先完成互動再回到主流程」的介面。它最大的優勢是傳參方式非常直觀,甚至可以讓子視窗直接存取父視窗的變數與方法。
vReturnValue = window.showModalDialog(sURL [, vArguments] [, sFeatures]);
sURL(必選)
字串類型,指定要在對話框中載入的頁面網址。
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 環境,一般網頁開發中較少使用。
10. dialogHide: { yes | no | 1 | 0 | on | off }
列印或列印預覽時是否隱藏對話框,預設 no。
11. edge: { sunken | raised }
對話框邊框樣式,預設 raised。
12. unadorned: { yes | no | 1 | 0 | on | off }
預設 no。
父頁面 parent.html:
<script>
function setname(res){
document.getElementById("name").value = res;
}
function selectTp(){
// 把父視窗的 setname 函式當作參數傳給子視窗
window.showModalDialog('child.html', setname,
'dialogWidth:300px;dialogHeight:300px;center:yes;');
}
</script>
<input type="button" value="提交" onclick="selectTp()" />
<input type="text" id="name" name="name" />
子頁面 child.html:
<script language="Javascript">
<!--
function setName(){
var win = "";
if(window.dialogArguments != null){
// 取出父視窗傳來的函式並呼叫,完成賦值
win = window.dialogArguments;
win('Jone');
}
this.close();
}
//-->
</script>
<input type="button" value="給父視窗賦值" onclick="setName()" />
這個範例的關鍵點是:父視窗把「函式本身」而不是資料當作參數傳入,子視窗拿到後直接呼叫,就能反向操作父視窗的 DOM。與只能單向回傳值的寫法相比,這種方式靈活得多。
需要注意的是,showModalDialog 屬於已廢棄的 IE 專屬 API,現代專案應改用 <dialog> 元素或自行以定位層+遮罩實作模態效果。