Window Object
The Window object corresponds to the browser window. A Window object is created automatically with every instance of a <body> or <frameset> tag.
The Window object's collections, objects, properties, methods, and events are described below:
N: Netscape (including Mozilla when N6 or higher), IE: Internet Explorer
Collections
| Collection | Description | N | IE |
|---|---|---|---|
| frames[] | Returns all named frames in the window | 2 | 3.02 |
Objects
| Object | Description | N | IE |
|---|---|---|---|
| clientInformation | Contains information about the browser | 4 | |
| clipboardData | 5 | ||
| document | Represents the HTML document object in the window. See'>http://www.w3schools.com/htmldom/dom_obj_document.asp">See Document object | 3.02 | |
| event | Represents the state of an event | 4 | |
| external | 4 | ||
| history | Contains the URLs visited from the window. See'>http://www.w3schools.com/htmldom/dom_obj_history.asp">See History object | 3.02 | |
| location | Contains the current URL of the window. See'>http://www.w3schools.com/htmldom/dom_obj_location.asp">See Location object | 3.02 | |
| navigator | Contains information about the browser. See'>http://www.w3schools.com/htmldom/dom_obj_navigator.asp">See Navigator object | 3.02 | |
| screen | Contains information about the client's screen. See'>http://www.w3schools.com/htmldom/dom_obj_screen.asp">See Screen object | 4 |
Properties
Syntax: window.property_name
| Property | Description | N | IE |
|---|---|---|---|
| closed | Returns a Boolean value that specifies whether the referenced window has been closed | 3 | 4 |
| defaultStatus | Sets or returns the default text in the statusbar of the windows (will be displayed when the page loads) | 2 | 3.02 |
| dialogArguments | Returns all variables passed into the modal dialog window | 4 | |
| dialogHeight | Sets or returns the height of the modal dialog window | 4 | |
| dialogLeft | Sets or returns the left coordinates of the modal dialog window | 4 | |
| dialogTop | Sets or returns the top coordinates of the modal dialog window | 4 | |
| dialogWidth | Sets or returns the width of the modal dialog window | 4 | |
| frameElement | Returns the frame/iframe object that is hosting the window in the parent document | 5.5 | |
| length | Sets or returns the number of frames in the window | 6 | 4 |
| name | Sets or returns the name of the window | 2 | 3.02 |
| offscreenBuffering | Sets or returns a Boolean value that specifies whether the window is drawn offscreen before being visible to the user | 4 | |
| opener | Sets or returns a reference to the window that created the window | 3 | 4 |
| parent | Returns the parent window | 2 | 3.02 |
| returnValue | Sets or returns the value returned from the modal dialog window | 4 | |
| screenLeft | Returns the x-coordinate of the upper left corner of the browser - relative to the upper left corner of the screen | 5 | |
| screenTop | Returns the y-coordinate of the top corner of the browser - relative to the top corner of the screen | 5 | |
| self | Returns a reference to the current window | 2 | 3.02 |
| status | Sets or returns the text in the statusbar of the window | 2 | 3.02 |
| top | Returns the topmost ancestor window | 2 | 3.02 |
Methods
Syntax: window.method_name()
| Method | Description | N | IE | ||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| alert("msg") | Displays an alert box with a message and an OK button | 2 | 3.02 | ||||||||||||||||||||||||||||||||||||||||||||||
| attachEvent("event",pointer) | 5 | ||||||||||||||||||||||||||||||||||||||||||||||||
| blur() | Removes focus from the current window | 3 | 4 | ||||||||||||||||||||||||||||||||||||||||||||||
| clearInterval(ID) | Cancels a timeout that is set with the setInterval() method | 4 | 4 | ||||||||||||||||||||||||||||||||||||||||||||||
| clearTimeout(ID) | Cancels a timeout that is set with the setTimeout() method | 2 | 3.02 | ||||||||||||||||||||||||||||||||||||||||||||||
| close() | Closes the current window | 2 | 3.02 | ||||||||||||||||||||||||||||||||||||||||||||||
| confirm("msg") | Displays a dialog box with a message, a Cancel, and an OK button | 2 | 3.02 | ||||||||||||||||||||||||||||||||||||||||||||||
| createPopup([args]) | Creates a pop-up window | 5.5 | |||||||||||||||||||||||||||||||||||||||||||||||
| execScript("code", "lang") | Executes a specified script. The arguments can take the following values:
| 4 | |||||||||||||||||||||||||||||||||||||||||||||||
| focus() | Sets focus on the current window | 3 | 4 | ||||||||||||||||||||||||||||||||||||||||||||||
| moveBy(x,y) | Moves the window a specified number of pixels in relation to its current co-ordinates | 4 | 4 | ||||||||||||||||||||||||||||||||||||||||||||||
| moveTo(x,y) | Moves the window's left and top edge to the specified co-ordinates | 4 | 4 | ||||||||||||||||||||||||||||||||||||||||||||||
| navigate("URL") | Loads the specified URL into the window | 3.02 | |||||||||||||||||||||||||||||||||||||||||||||||
| open(["URL", "name", "specs", replace]) | Opens a new browser window. The arguments can take the following values: "URL" - Optional. Specifies the URL of the page to display if no URL is specified, a new window with about:blank is displayed) "name" - Optional. Specifies the value for the target attribute on a form or a link. The following values are supported:
"specs" - Optional. A comma-separated list of items. The following values are supported:
replace - Optional.Specifies whether the URL creates a new entry or replaces the current entry in the history list. The following values are supported:
| 3.02 | |||||||||||||||||||||||||||||||||||||||||||||||
| print() | Prints the contents of the current window | 4 | 5 | ||||||||||||||||||||||||||||||||||||||||||||||
| prompt(["msg", "default"]) | Displays a dialog box prompting the user for input. The arguments can take the following values:
| 2 | 3.02 | ||||||||||||||||||||||||||||||||||||||||||||||
| resizeBy(x,y) | Resizes the window by the specified pixels. Note: This method does not work on dialog windows | 4 | |||||||||||||||||||||||||||||||||||||||||||||||
| resizeTo(width, height) | Resizes the window to the specified width and height. Note: This method does not work on dialog windows | 4 | |||||||||||||||||||||||||||||||||||||||||||||||
| scroll(x,y) | Deprecated. Use scrollTo() instead. | 4 | |||||||||||||||||||||||||||||||||||||||||||||||
| scrollBy(x,y) | Scrolls the content by the specified number of pixels. Note: The visible property of the window's scrollbar must be set to true if using this method | 4 | 4 | ||||||||||||||||||||||||||||||||||||||||||||||
| scrollTo(x,y) | Scrolls the content to the specified co-ordinates | 4 | 4 | ||||||||||||||||||||||||||||||||||||||||||||||
| setActive() | 5.5 | ||||||||||||||||||||||||||||||||||||||||||||||||
| setInterval(code, millisec[, "lang"]) | Calls a function / evaluate an expression every time a specified interval (in milliseconds) has been reached. The arguments can take the following values:
| 4 | 4 | ||||||||||||||||||||||||||||||||||||||||||||||
| setTimeout(code, millisec[, "lang"]) | Calls a function / evaluate an expression after a specified number of milliseconds. The arguments can take the following values:
| 3.02 | |||||||||||||||||||||||||||||||||||||||||||||||
| showHelp("URL"[, contextID]) | Displays a Help file (must be of type .htm or .chm). When using this method, a second Help box appears when pressing F1 or when clicking Help on the menu bar. To prevent the default Help box from appearing set returnValue to false. The arguments can take the following values:
| 4 | |||||||||||||||||||||||||||||||||||||||||||||||
| showModalDialog("URL"[, args, "list"]) | Loads a URL in a modal dialog box. A modal dialog box retains focus while open. The user CANNOT switch windows until the dialog box is closed. The arguments can take the following values: "URL" - Required. The URL of the document to display. args - Optional. The arguments to use when displaying the URL. Use this parameter to pass a value of any type, including an array of values. The dialog box can extract the values from the dialogArguments property of the window object. "list" - Optional. Specifies the window ornaments for the dialog box, using one or more of the following semicolon-delimited values:
| 4 | |||||||||||||||||||||||||||||||||||||||||||||||
| showModelessDialog("URL"[, args, "list"]) | Loads a URL in a modeless dialog box. The modeless dialog box displays even when the user switches focus to another window (useful for menus and Help systems). The arguments can take the following values: "URL" - Required. The URL of the document to display. args - Optional. The arguments to use when displaying the URL. Use this parameter to pass a value of any type, including an array of values. The dialog box can extract the values from the dialogArguments property of the window object. "list" - Optional. Specifies the window ornaments for the dialog box, using one or more of the following semicolon-delimited values:
| 5 |
* The default unit of measure for dialogHeight and dialogWidth in IE4 is em; in IE5 it is px. Other values to use: cm, mm, in, pt, pc, or ex. For consistent results, use px! Note: The min. dialogHeight you can specify is 100px.
Events
Syntax: window.event_name="someJavaScriptCode"
| Event | Description | N | IE |
|---|---|---|---|
| onBlur | Executes some code when a Blur event occurs | 3 | |
| onError | Executes some code when an Error event occurs | 3 | |
| onFocus | Executes some code when a Focus event occurs | 3 | |
| onLoad | Executes some code when an Load event occurs | 2 | |
| onResize | Executes some code when a Resize event occurs | 4 | |
| onUnload | Executes some code when an Unload event occurs | 2 |
No comments:
Post a Comment