METHOD:  Window::open
window.open(URL, name [, features])

This method is used to open a new browser window. Note that, when using this method with event handlers, you must use the syntax window.open() as opposed to just open(). Calling just open() will, because of the scoping of static objects in JavaScript, create a new document (equivalent to document.open()), not a window.
 
The available parameters are as follows:

URL - this is a string containing the URL of the document to open in the new window. If no URL is specified, an empty window will be created.

name - this is a string containing the name of the new window. This can be used as the 'target' attribute of a <FORM> or <A> tag to point to the new window.

features - this is an optional string that contains details of which of the standard window features are to be used with the new window. This takes the form of a comma-delimited list. Most of these features require yes or no (1 or 0 is also o.k.) and any of these can be turned on by simply listing the feature (they default to yes). Also, if you don't supply any of the feature arguments, all features with a choice of yes or no are enabled; if you do specify any feature parameters, titlebar and hotkeys still default to yes but all others are no.

Note that many of the values for the features parameter are Netscape only. Further, with the exception of dependent and hotkey, these Netscape only values represent potential sources of security problems and therefore require signed script (and user's permission) if they are to be used.

Details of the available values are given below:
features Value Description
alwaysLowered When set to yes, this creates a window that always floats below other windows.
alwaysRaised When set to yes, this creates a window that always floats above other windows.
dependent When set to yes, the new window is created as a child (closes when the parent window closes and does not appear on the task bar on Windows platforms) of the current window.
directories When set to yes, the new browser window has the standard directory buttons.
height This sets the height of the new window in pixels.
hotkeys When set to no, this disables the use of hotkeys (except security and quit hotkeys) in a window without a menubar.
innerHeight This sets the inner height of the window in pixels.
innerWidth This sets the inner width of the window in pixels.
location When set to yes, this creates the standard Location entry feild in the new browser window.
menubar When set to yes, this creates a new browser window with the standard menu bar (File, Edit, View, etc.).
outerHeight This sets the outer height of the new window in pixels.
outerWidth This sets the outer width of the new window in pixels.
resizable When set to yes this allows the resizing of the new window by the user.
screenX This allows a new window to be created at a specified number of pixels from the left side of the screen.
screenY This allows a new window to be created at a specified number of pixels from the top of the screen.
scrollbars When set to yes the new window is created with the standard horizontal and vertical scrollbars, where needed
status When set to yes, the new window will have the standard browser status bar at the bottom.
titlebar When set to yes the new browser window will have the standard title bar.
toolbar When set to yes the new window will have the standard browser tool bar (Back, Forward, etc.).
width This sets the width of the new window in pixels.
z-lock When set to yes this prevents the new window from rising above other windows when it is made active (given focus).

 
These features may only be used with IE4:
 
channelmode sets if the window appears in channel mode.
fullscreen the new window will appear in full screen.
left same as screenX, allows a new window to be created at a specified number of pixels from the left side of the screen.
top same as screenY, allows a new window to be created at a specified number of pixels from the top of the screen.

The following example creates a new window of the specified dimensions complete with toolbar, changes the background color and writes a message to it.

Code:
myWindow = window.open("", "tinyWindow", 'toolbar,width=150,height=100')
myWindow.document.write("Welcome to this new window!")
myWindow.document.bgColor="lightblue"
myWindow.document.close()

Output:
Copyright 1999-2001 by Infinite Software Solutions, Inc. All rights reserved.
Trademark Information