JS中window.showModalDialog()詳解
window.showModalDialog()方法用來建立一個顯示HTML內容的模態對話方塊。
window.showModelessDialog()方法用來建立一個顯示HTML內容的非模態對話方塊。
使用方法:
vReturnValue = window.showModalDialog(sURL [, vArguments] [,sFeatures])
vReturnValue = window.showModelessDialog(sURL [, vArguments] [,sFeatures])
引數說明:
sURL--必選引數,型別:字串。用來指定對話方塊要顯示的文件的URL。
vArguments--可選引數,型別:變體。用來向對話方塊傳遞引數。傳遞的引數型別不限,包括陣列等。對話方塊通過window.dialogArguments來取得傳遞進來的引數。
sFeatures-- 可選引數,型別:字串。用來描述對話方塊的外觀等資訊,可以使用以下的一個或幾個,用分號“;”隔開。
1.dialogHeight :對話方塊高度,不小於100px,IE4中dialogHeight 和 dialogWidth 預設的單位是em,而IE5以上是px,為方便其見,在定義modal方式的對話方塊時,用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+〕:是否顯示狀態列。預設為yes[ Modeless]或no[Modal]。
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。
引數傳遞:
1.要想對話方塊傳遞引數,是通過vArguments來進行傳遞的。型別不限制,對於字串型別,最大為4096個字元。也可以傳遞物件,例如:
-------------------------------
parent.htm
<script>
var obj = new Object();
obj.name="i5tt";
window.showModalDialog("modal.htm",obj,"dialogWidth=200px;dialogHeight=100px");
</script>
modal.htm
<script>
var obj = window.dialogArguments
alert("您傳遞的引數為:" + obj.name)
</script>
-------------------------------
2.可以通過window.returnValue向開啟對話方塊的視窗返回資訊,當然也可以是物件。例如:
------------------------------
parent.htm
<script>
str =window.showModalDialog("modal.htm",,"dialogWidth=200px;dialogHeight=100px");
alert(str);
</script>
modal.htm
<script>
window.returnValue="http://www.i5tt.com/";
</script>
將引數傳遞與返回結果結合在一起的例項
ParentPage.aspx
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title></title>
<script language="javascript" type="text/javascript">
function openwindow() {
var obj = new Object();
obj.value = "3";
obj.name = "4";
obj.sew = "5";
str =window.showModalDialog("ChildPage.aspx",obj,"dialogWidth=200px;dialogHeight=100px");
alert(str);
}
function openModelessDialog() {
var obj = new Object();
obj.value = "3";
obj.name = "4";
obj.sew = "5";
str = window.showModelessDialog("ChildPage.aspx", obj, "dialogWidth=200px;dialogHeight=100px");
alert(str);
}
</script>
</head>
<body>
<form id="form1" runat="server">
<div>
<input type="button" id="btnOpen" value="開啟模態視窗" onclick="openwindow();" />
<input type="button" id="Button1" value="開啟非模態視窗" onclick="openModelessDialog();" />
</div>
</form>
</body>
</html>
ChildPage.aspx
- <head runat="server">
<title></title>
<script language="javascript" type="text/javascript">
function getArguments() {
var obj = window.dialogArguments
alert("您傳遞的引數為:" + obj.value)
}
function windowclose() {
window.returnValue = "childPage.Close";
}
</script>
</head>
<body onunload="windowclose();">
<form id="form1" runat="server">
<div>
<input type="button" id="btnOpen" value="開啟視窗" onclick="getArguments();" />
<input type="button" id="btnClose" value="關閉視窗" onclick='self.close(); ' />
</div>
</form>
</body>
</html>