javascript网页对话框参数详解
2009-01-21 14:26 Kevin-wang 阅读(609) 评论(0) 编辑 收藏 举报
N.1 基本介绍:
* showModalDialog() (IE 4+ 支持),用来创建一个显示HTML内容的模态对话框。
* showModelessDialog() (IE 5+ 支持) ,用来创建一个显示HTML内容的非模态对话框。
N.2 使用方法:
* vReturnValue = window.showModalDialog(sURL [, vArguments] [,sFeatures])
* vReturnValue = window.showModelessDialog(sURL [, vArguments] [,sFeatures])
N.2.1 参数说明:
* 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。
10. 下面几个属性是用在HTA中的,在一般的网页中一般不使用。
11. dialogHide:{ yes | no | 1 | 0 | on | off }:在打印或者打印预览时对话框是否隐藏。默认为no。
12. edge:{ sunken | raised }:指明对话框的边框样式。默认为raised。
13. unadorned:{ yes | no | 1 | 0 | on | off }:默认为no。
N.3 参数传递:
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>
如果直接点右上角的关闭按钮关闭,那么返回undefined,可用是否为null来检测。
N.4 Firefox替代方案
Firefox 不支持showModalDialog,其实一开始是支持的,但后来发现它有安全性上的隐患,就把这个功能取消了。可使用 window.open代替,不过第三个参数要加上“modal=yes”,下面是一个示例,被打开的窗口修改父窗口的页面数据,值得注意的是,对于 innerText属性,修改后Firefox不会刷新页面,需要使用innerHTML属性:
* showModalDialog() (IE 4+ 支持),用来创建一个显示HTML内容的模态对话框。
* showModelessDialog() (IE 5+ 支持) ,用来创建一个显示HTML内容的非模态对话框。
N.2 使用方法:
* vReturnValue = window.showModalDialog(sURL [, vArguments] [,sFeatures])
* vReturnValue = window.showModelessDialog(sURL [, vArguments] [,sFeatures])
N.2.1 参数说明:
* 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。
10. 下面几个属性是用在HTA中的,在一般的网页中一般不使用。
11. dialogHide:{ yes | no | 1 | 0 | on | off }:在打印或者打印预览时对话框是否隐藏。默认为no。
12. edge:{ sunken | raised }:指明对话框的边框样式。默认为raised。
13. unadorned:{ yes | no | 1 | 0 | on | off }:默认为no。
N.3 参数传递:
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>
如果直接点右上角的关闭按钮关闭,那么返回undefined,可用是否为null来检测。
N.4 Firefox替代方案
Firefox 不支持showModalDialog,其实一开始是支持的,但后来发现它有安全性上的隐患,就把这个功能取消了。可使用 window.open代替,不过第三个参数要加上“modal=yes”,下面是一个示例,被打开的窗口修改父窗口的页面数据,值得注意的是,对于 innerText属性,修改后Firefox不会刷新页面,需要使用innerHTML属性:
function test2() { var frm = window.opener; frm.document.all["td22"].innerHTML = "abcd"; window.close(); }