DIV CSS 佈局教程網

window.showModalDialog 使用手冊
編輯:JavaScript基礎知識     

showModalDialog 是 IE 提供的方法,用來建立顯示 HTML 內容的對話框,在早期網頁開發中相當常用。以下整理它的基本概念與參數用法。

基本介紹

  • 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(可選,字串):描述對話框外觀等資訊,可用以下一或多個,以分號隔開:

  • 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(列印時是否隱藏,預設 no)、edge({sunken | raised} 邊框樣式,預設 raised)、unadorned(預設 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.51js.com";
</script>

需特別留意,這些方法僅在 Internet Explorer 中有效,不適用於其他瀏覽器。

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