Creates a modal dialog box that displays the specified HTML document.
Syntax
vReturnValue = object.showModalDialog(sURL [, vArguments] [, sFeatures])
Parameters
sURL |
Required. String that specifies the URL of the document to load and display. |
vArguments |
Optional. Variant that specifies the arguments to use when displaying the document. Use this parameter to pass a value of any type, including an array of values. The dialog box can extract the values passed by the caller from the dialogArguments property of the window object. |
sFeatures |
Optional. String that specifies the window ornaments for the dialog box, using one or more of the following semicolon-delimited values:
dialogHeight:sHeight
Sets the height of the dialog window (see Remarks for default unit of measure).
dialogLeft:sXPos
Sets the left position of the dialog window relative to the upper-left corner of the desktop.
dialogTop:sYPos
Sets the top position of the dialog window relative to the upper-left corner of the desktop.
dialogWidth:sWidth
Sets the width of the dialog window (see Remarks for default unit of measure).
center:{ yes | no | 1 | 0 | on | off }
Specifies whether to center the dialog window within the desktop. The default is yes.
dialogHide:{ yes | no | 1 | 0 | on | off }
Specifies whether the dialog window is hidden when printing or using print preview. This feature is only available when a dialog box is opened from a trusted application. The default is no.
edge:{ sunken | raised }
Specifies the edge style of the dialog window. The default is raised.
resizable:{ yes | no | 1 | 0 | on | off }
Specifies whether the dialog window has fixed dimensions. The default is no.
scroll:{ yes | no | 1 | 0 | on | off }
Specifies whether the dialog window displays scrollbars. The default is yes.
status:{ yes | no | 1 | 0 | on | off }
Specifies whether the dialog window displays a status bar. The default is yes for untrusted dialog windows and no for trusted dialog windows.
unadorned:{ yes | no | 1 | 0 | on | off }
Specifies whether the dialog window displays the border window chrome. This feature is only available when a dialog box is opened from a trusted application. The default is no.
|
Return Value
Variant. Returns the value of the returnValue property as set by the window of the document specified in sURL.
Remarks
A modal dialog box retains the input focus while open. The user cannot switch windows until the dialog box is closed.
Because a modal dialog box can include a URL to a resource in a different domain, do not pass information through the vArguments parameter that the user might consider private. The vArguments parameter can be referenced within the modal dialog box using the dialogArguments property of the window object. If the vArguments parameter is defined as a string, the maximum string length that can be passed to the modal dialog box is 4096 characters; longer strings are truncated.
As of Microsoft Internet Explorer 4.0, you can eliminate scroll bars on dialog boxes. To turn off the scroll bar, set the SCROLL attribute to false
in the body element for the dialog window, or call the modal dialog box from a trusted application.
Internet Explorer 5 and later allows further control over modal dialog boxes through the status
and resizable
values in the sFeatures parameter of the showModalDialog method. Turn off the status bar by calling the dialog box from a trusted application, such as Microsoft Visual Basic or an HTML Application (HTA), or from a trusted window, such as a trusted modal dialog box. These applications are considered to be trusted because they use Windows Internet Explorer interfaces instead of the browser. Any dialog box generated from a trusted source has the status bar turned off by default. Resizing is turned off by default, but you can turn it on by specifying resizable=yes
in the sFeatures string of the showModalDialog method.
You can set the default font settings the same way you set Cascading Style Sheets (CSS) attributes (for example, "font:3;font-size:4"
). To define multiple font values, use multiple font attributes.
The default unit of measure for dialogHeight
and dialogWidth
in Internet Explorer 5 and later is the pixel. The value can be an integer or floating-point number, followed by an absolute units designator (cm
, mm
, in
, pt
, or pc
) or a relative units designator (em
, ex
, or px
). For consistent results, specify the dialogHeight
and dialogWidth
in pixels when designing modal dialog boxes.
For Internet Explorer 7, dialogHeight
and dialogWidth
return the height and width of the content area and no longer includes the height and width of the frame.
Internet Explorer 7. Although a user can manually adjust the height of a dialog box to a smaller value —provided the dialog box is resizable— the minimum dialogHeight
you can specify is 100 pixels, and the minimum dialogWidth
you can define is 250 pixels. In versions earlier than Internet Explorer 7 the minimum value of the dialogWidth
that can be specified is 100 pixels.
To override center
, even though the default for center
is yes
, you can specify either dialogLeft
and/or dialogTop
.
This method must use a user-initiated action, such as clicking on a link or tabbing to a link and pressing enter, to open a pop-up window. The Pop-up Blocker feature in Internet Explorer 6 blocks windows that are opened without being initiated by the user.
Note For Internet Explorer 7, help
is not a valid value for sFeatures
. In previous versions, help:{ yes | no | 1 | 0 | on | off }
specified whether the dialog window displays the context-sensitive Help icon.
When Internet Explorer opens a window from a modal or modeless HTML dialog box by using the showModalDialog method or by using the showModelessDialog method, Internet Explorer uses Component Object Model (COM) to create a new instance of the window. Typically, the window is opened by using the first instance of an existing Internet Explorer process. When Internet Explorer opens the window in a new process, all the memory cookies are no longer available, including the session ID. This process is different from the process that Internet Explorer uses to open a new window by using the open method.
Examples
This example uses the showModalDialog method to open a customized dialog box.
<script type="text/javascript">
function fnRandom(iModifier){
return parseInt(Math.random()*iModifier);
}
function fnSetValues(){
var iHeight=oForm.oHeight.options[
oForm.oHeight.selectedIndex].text;
if(iHeight.indexOf("Random")>-1){
iHeight=fnRandom(document.body.clientHeight);
}
var sFeatures="dialogHeight: " + iHeight + "px;";
return sFeatures;
}
function fnOpen(){
var sFeatures=fnSetValues();
window.showModalDialog("showModalDialog_target.htm", "",
sFeatures)
}
</script>
<form name="oForm">
Dialog Height
<select name="oHeight">
<option>-- Random --</option>
<option>150</option>
<option>200</option>
<option>250</option>
<option>300</option>
</select>
Create Modal Dialog Box
<input type="button" value="Push To Create" onclick="fnOpen()">
</form>
Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/showModalDialog2.htm
Linked from the following button is an extended version of the above script, which demonstrates many of the features available for creating a custom dialog box.
Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/showModalDialog.htm
Neither modal nor modeless HTML dialog boxes support text selection or the standard shortcut menu for copy operations; however, you can imitate this functionality by using script with TextRange objects and event handlers for onmousedown and onmousemove, as in the following example.
Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/showModalDialogLaunch.htm
使用dialogArguments 得到父窗口传递的参数
window.showModalDialog(url,'',
"dialogHeight: 550px; dialogWidth: 750px;center: yes; help: no;resizable: no; status: no;");
相关推荐
javascript代码模块之如何使用showModalDialog
NULL 博文链接:https://crabdave.iteye.com/blog/269954
因为项目中使用showModalDialog函数的地方特别多,所以必须用一个类似方法实现功能,也就是window.open() 首先是判断子窗口关闭,因为项目是在子窗口关闭(确定按钮)的时候向父页面传递值的。
showModalDialog和showModelessDialog使用心得
ShowModalDialog 填充这是一个window.showModalDialog() shim,使用模态 HTML5 <dialog>元素和 ECMAScript 2015 Generators 或 ECMAScript 2017 Async/Await。 它在最新的 Google Chrome 和最新的 Mozilla Firefox ...
javascript代码模块之\Window.ShowModalDialog使用手册
今天使用showModalDialog打开页面,返回值时。当打开的页面点击关闭按钮或直接点浏览器上的关闭则返回值是undefined所以自作聪明判断 var reValue=window.showModalDialog(“”,””,””); if (reValue== ...
本文实例讲述了JS中showModalDialog关闭子窗口刷新主窗口用法。分享给大家供大家参考,具体如下: 网上找了好长时间 大都是window.opener.location.reload(),等等 都不是我想要的 最后终于发现了一个 想知道的就往下...
Selenium目前没有提供对IE模态对话框(即通过showModalDialog方法打开的弹出对话框)的处理。原因在于,模态对话框会将父页面的 JS挂起,直至对话框处理完毕才会继续执行父页面JS。因为Selenium的底层实现是基于JS的,...
showModalDialog及dialogArguments使用
NULL 博文链接:https://qsfwy.iteye.com/blog/587749
This is a `window.showModalDialog()` shim using a modal HTML5 `<dialog>` element and ECMAScript 6 Generators. It was tested in the latest Google Chrome with the *Enable Experimental JavaScript* flag ...
div层实现showModalDialog
针对window.showmodaldialog弹出窗体无刷新的详细使用
showModalDialog参数传递和获
showModalDialog参数详解 基本介绍: showModalDialog() (IE 4+ 支持) showModelessDialog() (IE 5+ 支持) window.showModalDialog()方法用来创建一个显示HTML内容的模态对话框。 window.showModelessDialog()...
ShowModalDialog函数的功能: 使用方法: 参数说明:
showModalDialog刷新窗口的例子
解决三层或心上showModalDialog的问题_2