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]]]])
Parameter Description 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
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.