Creates a modal dialog box that displays the specified HTML document.
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 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.
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" >
</form>
This feature requires Microsoft® Internet Explorer 4.0 or later. Click the following icon to install the latest version. Then reload this page to view the sample.
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.
This feature requires Microsoft® Internet Explorer 4.0 or later. Click the following icon to install the latest version. Then reload this page to view the sample.