open Method

MS Office DHTML, HTML & CSS

 
Click to return to the DHTML, HTML & CSS home page    
nextPage Method     open Method     DHTML Methods    

open Method


Opens a new window and loads the document specified by a given URL, or opens a blank document if a URL is not provided.

Syntax

oNewWindow=window.open([sURL] [, sName] [, sFeatures] [, bReplace])

Parameters

sURL Optional. String that specifies the URL of the document to display. If no URL is specified, a new window with about:blank is displayed.
sName Optional. String that specifies the name of the window. This name is used as the value for the TARGET attribute on a FORM or an A element.

In Internet Explorer 5 and later, specifying the value _search opens sURL in the browser's search pane.

sFeaturesOptional. String that specifies the window ornaments to display. The following features are supported:
channelmode = { yes | no | 1 | 0 }Specifies whether to display the window in theater mode and show the channel band. The default is no.
directories = { yes | no | 1 | 0 }Specifies whether to add directory buttons. The default is yes.
fullscreen = { yes | no | 1 | 0 }Specifies whether to display the browser in a full-screen or normal window. The default is no, which displays the browser in a normal window.

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 also closes the new window.

height = numberSpecifies the height of the window, in pixels. The minimum value is 100.
left = numberSpecifies the left position, in pixels. This value is relative to the upper-left corner of the screen.
location = { yes | no | 1 | 0 }Specifies whether to display the input field for entering URLs directly into the browser. The default is yes.
menubar = { yes | no | 1 | 0 }Specifies whether to display the menu bar. The default is yes.
resizable = { yes | no | 1 | 0 }Specifies whether to display resize handles at the corners of the window. The default is yes.
scrollbars = { yes | no | 1 | 0 }Specifies whether to display horizontal and vertical scroll bars. The default is yes.
status = { yes | no | 1 | 0 }Specifies whether to add a status bar at the bottom of the window. The default is yes.
titlebar = { yes | no | 1 | 0 }Specifies whether to display a title bar for the window. This parameter is ignored unless the caller is an html applicationInternet Link or a trusted dialog box. The default is yes.
toolbar = { yes | no | 1 | 0 }Specifies whether to display the browser toolbar, making buttons such as Back, Forward, and Stop available. The default is yes.
top = numberSpecifies the top position, in pixels. This value is relative to the upper-left corner of the screen.
width = numberSets the width of the window, in pixels. The minimum value is 100.
bReplaceOptional. Boolean that specifies 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 set to true, no new history entry is created.

Return Value

Returns a reference to the new window object. Use this reference to script properties and methods on the new window.

Remarks

By default, the open method creates a window that has a default width and height and the standard menu, toolbar, and other features of Microsoft® Internet Explorer. You can alter this set of features by using the sFeatures parameter. This parameter is a string consisting of one or more feature settings. When one feature is specified, any additional features that are not specified are disabled. If no features are specified, the window features maintain their default values. In addition to enabling a feature with the specified possible value, simply listing the feature name also enables that feature for the new window.

Internet Explorer 5 allows further control over windows through the implementation of title in the sFeatures parameter of the open method. Turn off the title bar by opening the window from a trusted application, such as Microsoft® Visual Basic® or an HTML Application (HTA). These applications are considered trusted, because each uses Internet Explorer interfaces instead of the browser.

Windows CE

In Microsoft® Windows® CE, the document object is not available through scripting for a window opened using the open method.

Example

This example uses the open method to create a new window that contains Sample.htm. The new window is 200 pixels by 400 pixels and has a status bar, but it 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

[ Object Name ]
PlatformVersion
Win16:
Win32:
Mac:
Unix:
WinCE:
Version data is listed when the mouse hovers over a link, or the link has focus.

window


Back to topBack to top

Did you find this topic useful? Suggestions for other topics? write us!Internet Link

© 1999 microsoft corporation. all rights reserved. terms of useInternet Link.