DIV CSS 佈局教程網

window.showModalDialog 模態視窗用法完整解析
編輯:關於JavaScript     

什麼是 showModalDialog?

showModalDialog 開啟的是一種模態視窗(modal window)。它的特性在於:視窗打開期間,父視窗會進入「暫停」狀態,使用者無法再去操作背後的父視窗,直到這個模態子視窗被關閉為止。

在傳統的 Ajax 開發場景裡,這個方法常被拿來做表單填寫、線上問答、資料挑選這類需要「先完成互動再回到主流程」的介面。它最大的優勢是傳參方式非常直觀,甚至可以讓子視窗直接存取父視窗的變數與方法。

基本語法

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

參數說明

sURL(必選)
字串類型,指定要在對話框中載入的頁面網址。

vArguments(可選)
變體類型,用來向對話框傳遞參數。型別不受限制,陣列、物件都可以。子視窗透過 window.dialogArguments 取得這些值。

sFeatures(可選)
字串類型,用來描述對話框的外觀與行為,多個設定之間以分號「;」隔開。

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> 元素或自行以定位層+遮罩實作模態效果。

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