DIV CSS 佈局教程網

showModalDialog 參數用法詳解:外觀、傳值與回傳
編輯:JavaScript綜合知識     

showModalDialog() 曾是 IE 上實作模態對話框的主要手段,能開啟一個「必須先關掉才能操作背後視窗」的子視窗,而且傳值方式相當靈活。以下完整說明它的參數與用法。要注意這套 API 已從標準中移除,僅供維護舊系統時參考。

基本介紹

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 — 可選,字串。描述對話框外觀,可用一或多個項目,以分號隔開。

sFeatures 可用項目

  • dialogHeight:對話框高度,不小於 100px。
  • 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:{ yes | no | 1 | 0 | on | off } 列印或預覽時是否隱藏,預設 no。
  • edge:{ sunken | raised } 邊框樣式,預設 raised。
  • unadorned:{ yes | no | 1 | 0 | on | off } 預設 no。

參數傳遞:傳入

透過 vArguments 傳值,型別不限。字串型別最大 4096 字元,也可以傳物件:

// parent.htm
<script>
var obj = new Object();
obj.name = "51js";
window.showModalDialog("modal.htm", obj, "dialogWidth=200px;dialogHeight=100px");
</script>

// modal.htm
<script>
var obj = window.dialogArguments;
alert("您傳遞的參數為:" + obj.name);
</script>

參數傳遞:回傳

透過 window.returnValue 向開啟對話框的視窗回傳資訊,同樣可以是物件:

// parent.htm
<script>
str = window.showModalDialog("modal.htm", , "dialogWidth=200px;dialogHeight=100px");
alert(str);
</script>

// modal.htm
<script>
window.returnValue = "https://www.jb51.net";
</script>

注意父視窗那行是同步等待的:showModalDialog 會阻塞在該行直到對話框關閉,所以下一行的 alert(str) 才能拿到值。這與非模態版本不同。

單位的小陷阱

IE4 中 dialogHeight 與 dialogWidth 的預設單位是 em,IE5 之後改為 px。為了避免歧異,定義模態對話框時建議一律明確標註 px。

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