open
Contents Index Topic Contents
Previous Topic: nextPage
Next Topic: open
open
Description
Opens a new window and loads the document given by URL, or a blank document
if a URL is not provided.
Syntax
window = object.open([URL [, name [, features [, replace]]]])
ParameterDescription
URL String specifying the URL of the document to display. If no URL is
specified, a new window with about:blank will be displayed.
name Optional. String specifying the name of the window. This name is
used for TARGET on a FORM or an A.
features Optional. String specifying the window ornaments to display.
The following table lists the supported features. Syntax
Description
fullscreen={ yes | no | 1 | 0 } Specifies whether to display the
browser in a full-screen or normal window. Default is no.
Use full-screen mode carefully. Because this mode hides the
browser's title bar and menus, you should always provide a
button or other visual clue to help the user close the window.
ALT+F4 will also close the new window.
channelmode={ yes | no | 1 | 0 } Specifies whether to display
the window in theater mode and show the channel band.
toolbar={ yes | no | 1 | 0 } Specifies whether to display the
browser toolbar, making buttons such as Back, Forward, and Stop
available.
location= { yes | no | 1 | 0 } Specifies whether to display the
input field for entering URLs directly into the browser.
directories = { yes | no | 1 | 0 } Specifies whether to add
directory buttons. Default is no.
status={ yes | no | 1 | 0 } Specifies whether to add a status
bar at the bottom of the window. Default is yes.
menubar={ yes | no | 1 | 0} Specifies whether to display the
menu bar. Default is yes.
scrollbars={ yes | no | 1 | 0} Specifies whether to display
horizontal and vertical scroll bars. Default is yes.
resizable={ yes | no | 1 | 0} Specifies whether to display
resize handles at the corners of the window.
width=number Sets the width of the window, in pixels. Minimum
value should be 100.
height=number Specifies the height of the window, in pixels.
Minimum value should be 100.
top=number Specifies the top position, in pixels. This value is
relative to the upper-left corner of the screen.
left=number Specifies the left position, in pixels. This value
is relative to the upper-left corner of the screen.
replace Optional. A boolean value specifying whether the URL that is
loaded into the new page should create a new entry in the window's
browsing history or replace the current entry in the browsing history.
If true, no new history entry is created.
Return Value
Returns a reference to the new window. Use this reference to script
properties and methods on the new window.
Remarks
A name for the new window can be used as a target for a form or an A
element. By default, the open() method creates a window that has a default
width and height and the standard menu, toolbar, and other features of
Internet Explorer. You can alter this set of features by using the features
parameter. This parameter is a string consisting of one or more feature
settings. The replace parameter controls whether the new window is put into
the browser history list.
For example, the following creates a new window that contains Sample.htm.
The new window is 200 by 400 pixels, has a status bar, but does not have a
toolbar, menu bar, or address field.
window.open("sample.htm",null,
"height=200,width=400,status=yes,toolbar=no,menubar=no,location=no");
Applies To
window
Top of Page
?1997 Microsoft Corporation. All rights reserved. Terms of Use.