js showModalDialog
关于window.showModalDialog()打开模态窗口的使用方法。备忘。
一、使用方法
vReturnValue = window.showModalDialog(sURL [, vArguments] [,sFeatures])
vReturnValue = window.showModelessDialog(sURL [, vArguments] [,sFeatures])
二、参数说明
sURL -- 必选参数,类型:字符串。用来指定对话框要显示的文档的URL。
vArguments -- 可选参数,类型:变体。用来向对话框传递参数。传递的参数类型不限,包括数组等。对话框通过window.dialogArguments来取得传递进来的参数。
sFeatures -- 可选参数,类型:字符串。用来描述对话框的外观等信息,可以使用以下的一个或几个,用分号“;”隔开。
----------------
1. dialogHeight: 对话框高度,不小于100px
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.在showModalDialog和showModelessDialog窗口中,点击超连接不弹出新窗口,在<head>中加上如下语句:
<base target="_self">
2.在showModalDialog窗口中,使用location.href="test.jsp"语句,会打开新窗口显示新页面,可以使用如下语句代替:
<script>
window.name="targetSelf";
window.open("test.jsp","targetSelf");
</script>
3.在showModalDialog窗口中,提交数据而不打开新窗口,需要指定window.name,语句如下:
window.name="targetName";
function postData(){
var aform = document.forms[0];
aform.action = url;
aform.target="targetName";
aform.submit();
}
另外,一种解决方式是使用iframe。
4.鼠标拖动showModalDialog窗口,使其大小可变,其参数形式如下(供参考):
window.showModalDialog(url,"1","edge: Raised; center: Yes; help: Yes; resizable: Yes; status: Yes; dialogWidth=1100px;dialogHeight=655px");
四、参数传递:
1. 对showModalDialog窗口传递参数,是通过vArguments参数来传递的。
类型不限制,对于字符串类型,最大为4096个字符。
也可以传递对象,例如:
-------------------------------
parent.htm
<script>
var obj = new Object();
obj.name="test";
window.showModalDialog("modal.htm",obj,"dialogWidth=200px;dialogHeight=100px");
</script>
modal.htm
<script>
var obj = window.dialogArguments;
alert("您传递的参数为:" + obj.name);
</script>
-------------------------------
2.在showModalDialog窗口中,使用window.returnValue可向父窗口返回信息,也可以返回对象。
例如:
------------------------------
parent.htm
<script>
str =window.showModalDialog("modal.htm","1","dialogWidth=200px;dialogHeight=100px");
alert(str);
</script>
modal.htm
<script>
window.returnValue=1;
window.close();
</script>
------------------------------