①基本介绍
showModalDialog() (IE 4+ 支持),用来创建一个显示HTML内容的模态对话框。
showModelessDialog() (IE 5+ 支持) ,用来创建一个显示HTML内容的非模态对话框。
②使用方法
vReturnValue = window.showModalDialog(sURL [, vArguments] [,sFeatures])
vReturnValue = window.showModelessDialog(sURL [, vArguments] [,sFeatures])
③参数说明
sURL:必选参数,类型:字符串。用来指定对话框要显示的文档的URL。
vArguments:可选参数,类型:变体。用来向对话框传递参数。传递的参数类型不限,包括数组等。对话框通过window.dialogArguments来取得传递进来的参数。
sFeatures:可选参数,类型:字符串。用来描述对话框的外观等信息,可以使用以下的一个或几个,用分号“;”隔开。
dialogHeight:对话框高度,不小于100px,IE4中dialogHeight 和 dialogWidth 默认的单位是em,而IE5中是px,为方便其见,在定义modal方式的对话框时,用px做单位。
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+]:是否显示状态栏。默认为yes[ Modeless]或no[Modal]。
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。
③参数传递
1、要想对话框传递参数,是通过vArguments来进行传递的。类型不限制,对于字符串类型,最大为4096个字符。也可以传递对象,例如:
Page1.htm
<script>
var obj = new Object();
obj.name="dzwebs";
window.showModalDialog("Page2.htm",obj,"dialogWidth=200px;dialogHeight=100px");
</script>
Page2.htm
<script>
var obj = window.dialogArguments
alert("您传递的参数为:" + obj.name)
</script>
2、可以通过window.returnValue向打开对话框的窗口返回信息,当然也可以是对象。例如:
Page1.htm
<script>
str =window.showModalDialog("Page2.htm", "","dialogWidth=200px;dialogHeight=100px");
alert(str);
</script>
Page2.htm
<script> window.returnValue="www.dzwebs.net"; </script>
如果直接点右上角的关闭按钮关闭,那么返回undefined,可用是否为null来检测。
④Firefox替代方案
Firefox不支持showModalDialog,其实一开始是支持的,但后来发现它有安全性上的隐患,就把这个功能取消了。可使用window.open代替,不过第三个参数要加上“modal=yes”,下面是一个示例,被打开的窗口修改父窗口的页面数据,值得注意的是,对于innerText属性,修改后Firefox不会刷新页面,需要使用innerHTML属性:
function test2() { var frm = window.opener; frm.document.all["Mytext"].innerHTML = "dzwebs"; window.close(); }
⑤技巧集
使showModalDialog打开的页面自动刷新
通过ShowModalDialog打开的页面会自动从IE的缓存中获得内容并显示。如果想每次通过ShowModalDialog打开的页面都自动刷新的话,只需要在脚本中设定一个参数,例如:
ShowModalDialog("xxx.aspx?id=1&tempid=" + Math.random());
其中tempid是一个xxx.aspx中并不需要使用到的参数,只要这个参数每次不同,通过ShowModalDialog打开的页面就都会自动刷新。