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 中有效,不適用於其他瀏覽器。