window.showModalDialog使用手册

window.showModalDialog使用手册
2011年03月01日
　　 基本介绍： 
　　showModalDialog()                              (IE 4+ 支持) 
　　showModelessDialog()                         (IE 5+ 支持) 
　　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 
　　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 
　　 
　　var obj = new Object(); 
　　obj.name="51js"; 
　　window.showModalDialog("modal.htm",obj,"dialogWidt h=200px;dialogHeight=100px"); 
　　 
　　modal.htm 
　　 
　　var obj = window.dialogArguments 
　　alert("您传递的参数为：" + obj.name) 
　　 
　　------------------------------- 
　　2.   可以通过window.returnValue向打开对话框的窗口返回信息，当然也可以是对象。例如： 
　　------------------------------ 
　　parent.htm 
　　 
　　str =window.showModalDialog("modal.htm",,"dialogWidth= 200px;dialogHeight=100px"); 
　　alert(str); 
　　 
　　modal.htm 
　　 
　　window.returnValue="http://homepage.yesky.com"; 
　　 
　　一、showModalDialog和showModelessDialog有什么不同？ 
　　showModalDialog：被打开后就会始终保持输入焦点。除非对话框被关闭，否则用户无法切换到主窗口。类似alert的运行效果。 
　　showModelessDialog：被打开后，用户可以随机切换输入焦点。对主窗口没有任何影响(最多是被挡住一下而以。:P) 
　　二、怎样才让在showModalDialog和showModelessDialog的超连接不弹出新窗口？ 
　　在被打开的网页里加上就可以了。这句话一般是放在和之间的。 
　　三、怎样才刷新showModalDialog和showModelessDialog里的内容？ 
　　在showModalDialog和showModelessDialog里是不能按F5刷新的，又不能弹出菜单。这个只能依靠javascript了，以下是相关代码： 
　　 
　　reload... 
　　将filename.htm替换成网页的名字然后将它放到你打开的网页里，按F5就可以刷新了，注意，这个要配合使用，不然你按下F5会弹出新窗口的。 
　　四、如何用javascript关掉showModalDialog(或showModelessDialog)打开的窗口。 
　　 
　　也要配合，不然会打开一个新的IE窗口，然后再关掉的。 
　　五、showModalDialog和showModelessDialog数据传递技巧。 
　　(作者语：本来想用一问一答形式来写的，但是我想不出这个怎么问，所以只好这样了。) 
　　这个东西比较麻烦，我改了好几次了不是没办法说明白(语文水平越来越差了)，只好用个例子说明了。 
　　例子： 
　　现在需要在一个showModalDialog(或showModelessDialog)里读取或设置一个变量var_name 
　　一般的传递方式： 
　　window.showModalDialog("filename.htm",var_name) 
　　//传递var_name变量 
　　在showModalDialog(或showModelessDialog)读取和设置时： 
　　alert(window.dialogArguments)//读取var_name变量 
　　window.dialogArguments="oyiboy"//设置var_name变量 
　　这种方式是可以满足的，但是当你想在操作var_name同时再操作第二个变理var_id时呢？就无法再进行操作了。这就是这种传递方式的局限性。 
　　以下是我建议使用的传递方式： 
　　window.showModalDialog("filename.htm",window) 
　　//不管要操作什么变量，只直传递主窗口的window对象 
　　在showModalDialog(或showModelessDialog)读取和设置时： 
　　alert(window.dialogArguments.var_name)//读取var_name变量 
　　window.dialogArguments.var_name="oyiboy"//设置var_name变量 
　　同时我也可以操作var_id变量 
　　alert(window.dialogArguments.var_id)//读取var_id变量 
　　window.dialogArguments.var_id="001"//设置var_id变量 
　　同样还可以对主窗口的任何对象进行操作，如form对象里的元素。 
　　window.dialogArguments.form1.index1.value="这是在设置index1元素的值" 
　　在父页面中用onClick=""var reVal = window.showModalDialog('changephoto.htm','dialogWi dth:500px;dialogHeight:300px;help:no');if (typeof(reVal) != 'undefined') {form.textname.value=reVal;}"" style=""cursor:hand "">点击这里修改图片 
　　在字窗口'changephoto.htm'中打开一个框架集，框架集中包含一个asp文件，先将asp的值返回到changephoto.htm中 再将这个值返回到主页面中 
　　changephoto.htm:  
　　function onClose() { window.returnValue = form1.save.value;//也可以将window.returnValue改成window.dialogArguments.oblogform.blogimage.value window.close(); } 
　　asp文件：parent.document.form1.save.value ="值或变量";