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>
------------------------------

 

 

                                      by JRQ

                                  2010/01/26夜 南昌

你可能感兴趣的:(showModalDialog)