window.showModalDialog使用手册

  作者:norika 整理日期:2004年6月17日

  基本介绍:

  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,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="51js";

  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.51js.com";

  </script>