document
, Location
, and History
object group.
Client-side object. | |
Implemented in |
Navigator 2.0 Navigator 3.0: added closed , history , and opener properties; added blur , focus , and scroll methods; added onBlur , onError , and onFocus event handlersNavigator 4.0: added innerHeight , innerWidth , locationbar , menubar , outerHeight , outerWidth , pageXOffset , pageYOffset , personalbar , scrollbars , statusbar , and toolbar properties; added back , captureEvents , clearInterval , disableExternalCapture , enableExternalCapture , find , forward , handleEvent , home , moveBy , moveTo , releaseEvents , resizeBy , resizeTo , routeEvent , scrollBy , scrollTo , setInterval , and stop methods; deprecated scroll method.
|
Window
object for each
BODY
or FRAMESET
tag. It also creates a Window
object to represent each frame defined in a FRAME
tag. In addition, you can create other windows by calling the Window.open
method. For details on defining a window, see open
.onBlur
or onFocus
event handler in a FRAMESET
tag has no effect. Window
object is the top-level object in the JavaScript client hierarchy. A Window
object can represent either a top-level window or a frame inside a frameset. As a matter of convenience, you can think about a Frame
object as a Window
object that isn't a top-level window. However, there is not really a separate Frame
class; these objects really are Window
objects, with a very few minor differences:
parent
and top
properties are references to the window itself. For a frame, the top
refers to the topmost browser window, and parent
refers to the parent window of the current window. defaultStatus
or status
property sets the text appearing in the browser status line. For a frame, setting these properties only sets the status line text when the cursor is over the frame.close
method is not useful for windows that are frames.onBlur
or onFocus
event handler for a frame, you must set the onblur
or onfocus
property and specify it in all lowercase (you cannot specify it in HTML).FRAME
tag contains SRC
and NAME
attributes, you can refer to that frame from a sibling frame by using parent.frameName
or parent.frames[index]
. For example, if the fourth frame in a set has NAME="homeFrame"
, sibling frames can refer to that frame using parent.homeFrame
or parent.frames[3]
.self
and window
properties of a Window
object are synonyms for the current window, and you can optionally use them to refer to the current window. For example, you can close the current window by calling the close
method of either window
or self
. You can use these properties to make your code more readable or to disambiguate the property reference self.status
from a form called status
. See the properties and methods listed below for more examples.
Because the existence of the current window is assumed, you do not have to refer to the name of the window when you call its methods and assign its properties. For example, status="Jump to a new location"
is a valid property assignment, and close()
is a valid method call.
A windows lacks event handlers until HTML that contains a BODY
or FRAMESET
tag is loaded into it.
window2
, and defines push buttons that open a message window, write to the message window, close the message window, and close window2
. The onLoad
and onUnload
event handlers of the document loaded into window2
display alerts when the window opens and closes.
win1.html
, which defines the frames for the first window, contains the following code:
<HTML>
<HEAD>
<TITLE>Window object example: Window 1</TITLE>
</HEAD>
<BODY BGCOLOR="antiquewhite">
<SCRIPT>
window2=open("win2.html","secondWindow",
"scrollbars=yes,width=250, height=400")
document.writeln("<B>The first window has no name: "
+ window.name + "</B>")
document.writeln("<BR><B>The second window is named: "
+ window2.name + "</B>")
</SCRIPT>
<FORM NAME="form1">
<P><INPUT TYPE="button" VALUE="Open a message window"
onClick = "window3=window.open('','messageWindow',
'scrollbars=yes,width=175, height=300')">
<P><INPUT TYPE="button" VALUE="Write to the message window"
onClick="window3.document.writeln('Hey there');
window3.document.close()">
<P><INPUT TYPE="button" VALUE="Close the message window"
onClick="window3.close()">
<P><INPUT TYPE="button" VALUE="Close window2"
onClick="window2.close()">
</FORM>
</BODY>
</HTML>
win2.html
, which defines the content for window2
, contains the following code:<HTML>Example 2. Creating frames. The following example creates two windows, each with four frames. In the first window, the first frame contains push buttons that change the background colors of the frames in both windows.
<HEAD>
<TITLE>Window object example: Window 2</TITLE>
</HEAD>
<BODY BGCOLOR="oldlace"
onLoad="alert('Message from ' + window.name + ': Hello, World.')"
onUnload="alert('Message from ' + window.name + ': I\'m closing')">
<B>Some numbers</B>
<UL><LI>one
<LI>two
<LI>three
<LI>four</UL>
</BODY>
</HTML>
framset1.html
, which defines the frames for the first window, contains the following code:<HTML>
<HEAD>
<TITLE>Frames and Framesets: Window 1</TITLE>
</HEAD>
<FRAMESET ROWS="50%,50%" COLS="40%,60%"
onLoad="alert('Hello, World.')">
<FRAME SRC=framcon1.html NAME="frame1">
<FRAME SRC=framcon2.html NAME="frame2">
<FRAME SRC=framcon2.html NAME="frame3">
<FRAME SRC=framcon2.html NAME="frame4">
</FRAMESET>
</HTML>
framset2.html
, which defines the frames for the second window, contains the following code:<HTML>
<HEAD>
<TITLE>Frames and Framesets: Window 2</TITLE>
</HEAD>
<FRAMESET ROWS="50%,50%" COLS="40%,60%">
<FRAME SRC=framcon2.html NAME="frame1">
<FRAME SRC=framcon2.html NAME="frame2">
<FRAME SRC=framcon2.html NAME="frame3">
<FRAME SRC=framcon2.html NAME="frame4">
</FRAMESET>
</HTML>
framcon1.html
, which defines the content for the first frame in the first window, contains the following code:<HTML>
<BODY>
<A NAME="frame1"><H1>Frame1</H1></A>
<P><A HREF="framcon3.htm" target=frame2>Click here</A>
to load a different file into frame 2.
<SCRIPT>
window2=open("framset2.htm","secondFrameset")
</SCRIPT>
<FORM>
<P><INPUT TYPE="button" VALUE="Change frame2 to teal"
onClick="parent.frame2.document.bgColor='teal'">
<P><INPUT TYPE="button" VALUE="Change frame3 to slateblue"
onClick="parent.frames[2].document.bgColor='slateblue'">
<P><INPUT TYPE="button" VALUE="Change frame4 to darkturquoise"
onClick="top.frames[3].document.bgColor='darkturquoise'">
<P><INPUT TYPE="button" VALUE="window2.frame2 to violet"
onClick="window2.frame2.document.bgColor='violet'">
<P><INPUT TYPE="button" VALUE="window2.frame3 to fuchsia"
onClick="window2.frames[2].document.bgColor='fuchsia'">
<P><INPUT TYPE="button" VALUE="window2.frame4 to deeppink"
onClick="window2.frames[3].document.bgColor='deeppink'">
</FORM>
</BODY>
</HTML>
framcon2.html
, which defines the content for the remaining frames, contains the following code:<HTML>
<BODY>
<P>This is a frame.
</BODY>
</HTML>
framcon3.html
, which is referenced in a Link
object in framcon1.html
, contains the following code:<HTML>
<BODY>
<P>This is a frame. What do you think?
</BODY>
</HTML>
document
, Frame
Property of |
Window
|
Read-only | |
Implemented in | Navigator 3.0 |
closed
property is a boolean value that specifies whether a window has been closed. When a window closes, the window
object that represents it continues to exist, and its closed
property is set to true.
Use closed
to determine whether a window that you opened, and to which you still hold a reference (from the return value of window.open
), is still open. Once a window is closed, you should not attempt to manipulate it.
win1
, then later checks to see if that window has been closed. A function is called depending on whether win1
is closed.win1=window.open('opener1.html','window1','width=300,height=300')Example 2. The following code determines if the current window's opener window is still closed, and calls the appropriate function.
...
if (win1.closed)
function1()
else
function2()
if (window.opener.closed)
function1()
else
function2()
Window.close
, Window.open
Property of |
Window
|
Implemented in | Navigator 2.0 |
defaultStatus
message appears when nothing else is in the status bar. Do not confuse the defaultStatus
property with the status
property. The status
property reflects a priority or transient message in the status bar, such as the message that appears when a mouseOver
event occurs over an anchor.
You can set the defaultStatus
property at any time. You must return true if you want to set the defaultStatus
property in the onMouseOut
or onMouseOver
event handlers.
statusSetter
function sets both the status
and defaultStatus
properties in an onMouseOver
event handler:function statusSetter() {
window.defaultStatus = "Click the link for the Netscape home page"
window.status = "Netscape home page"
}
<A HREF="http://home.netscape.com"In the previous example, notice that the
onMouseOver = "statusSetter(); return true">Netscape</A>
onMouseOver
event handler returns a value of true. You must return true to set status
or defaultStatus
in an event handler.Window.status
Property of |
Window
|
Implemented in | Navigator 2.0 |
document
object.FRAME
tag) in source order.
Property of |
Window
|
Read-only | |
Implemented in | Navigator 2.0 |
You can refer to the child frames of a window by using the frames
array. This array contains an entry for each child frame (created with the FRAME
tag) in a window containing a FRAMESET
tag; the entries are in source order. For example, if a window contains three child frames whose NAME
attributes are fr1
, fr2
, and fr3
, you can refer to the objects in the images
array either as:
parent.frames["fr1"]or as:
parent.frames["fr2"]
parent.frames["fr3"]
parent.frames[0]You can find out how many child frames the window has by using the
parent.frames[1]
parent.frames[2]
length
property of the Window
itself or of the frames
array.
The value of each element in the frames
array is <object nameAttribute>
, where nameAttribute
is the NAME
attribute of the frame.
Property of |
Window
|
Implemented in | Navigator 3.0 |
History
object.
Property of |
Window
|
Implemented in | Navigator 4.0 |
UniversalBrowserWrite
privilege. For information on security in Navigator 4.0, see Chapter 7, "JavaScript Security," in the JavaScript Guide.Window.innerWidth
, Window.outerHeight
, Window.outerWidth
Property of |
Window
|
Implemented in | Navigator 4.0 |
UniversalBrowserWrite
privilege. For information on security in Navigator 4.0, see Chapter 7, "JavaScript Security," in the JavaScript Guide. Window.innerHeight
, Window.outerHeight
, Window.outerWidth
Property of |
Window
|
Read-only | |
Implemented in | Navigator 2.0 |
length
property of the frames
array.
Property of |
Window
|
Implemented in | Navigator 2.0 |
Location
object.
Property of |
Window
|
Implemented in | Navigator 4.0 |
locationbar
property itself has one property, visible
. If true, the location bar is visible; if false, it is hidden.visible
property requires the UniversalBrowserWrite
privilege. For information on security in Navigator 4.0, see Chapter 7, "JavaScript Security," in the JavaScript Guide. self.menubar.visible=false;
self.toolbar.visible=false;
self.locationbar.visible=false;
self.personalbar.visible=false;
self.scrollbars.visible=false;
self.statusbar.visible=false;
Property of |
Window
|
Implemented in | Navigator 4.0 |
menubar
property itself one property, visible
. If true, the menu bar is visible; if false, it is hidden.visible
property requires the UniversalBrowserWrite
privilege. For information on security in Navigator 4.0, see Chapter 7, "JavaScript Security," in the JavaScript Guide. self.menubar.visible=false;
self.toolbar.visible=false;
self.locationbar.visible=false;
self.personalbar.visible=false;
self.scrollbars.visible=false;
self.statusbar.visible=false;
Property of |
Window
|
Read-only (2.0); Modifiable (later versions) | |
Implemented in | Navigator 2.0 |
NAME
was a read-only property. In later versions, this property is modifiable by your code. This allows you to assign a name to a top-level window.netscapeWin
. The second statement displays the value "netscapeHomePage"
in the Alert dialog box, because "netscapeHomePage"
is the value of the windowName
argument of netscapeWin
.netscapeWin=window.open("http://home.netscape.com","netscapeHomePage")
alert(netscapeWin.name)
open
method.
Property of |
Window
|
Implemented in | Navigator 3.0 |
open
method, the opener
property specifies the window of the source document. Evaluate the opener
property from the destination window.This property persists across document unload in the opened window.
You can change the opener
property at any time.
You may use Window.open
to open a new window and then use Window.open
on that window to open another window, and so on. In this way, you can end up with a chain of opened windows, each of which has an opener
property pointing to the window that opened it.
opener
is unchanged. However, window.opener.name
then evaluates to undefined.window.opener.close()Example 2: Close the main browser window.
top.opener.close()Example 3: Evaluate the name of the opener. A window can determine the name of its opener as follows:
document.write("<BR>opener property is " + window.opener.name)Example 4: Change the value of opener. The following code changes the value of the
opener
property to null. After this code executes, you cannot close the opener window as shown in Example 1.window.opener=nullExample 5: Change a property of the opener. The following code changes the background color of the window specified by the
opener
property.window.opener.document.bgColor='bisque'
Window.close
, Window.open
Property of |
Window
|
Implemented in | Navigator 4.0 |
Window.innerWidth
, Window.innerHeight
, Window.outerWidth
Property of |
Window
|
Implemented in | Navigator 4.0 |
Window.innerWidth
, Window.innerHeight
, Window.outerHeight
Property of |
Window
|
Read-only | |
Implemented in | Navigator 4.0 |
pageXOffset
property provides the current x-position of a page as it relates to the upper-left corner of the window's content area. This property is useful when you need to find the current location of the scrolled page before using scrollTo
or scrollBy
. x = myWindow.pageXOffset
Window.pageYOffset
Property of |
Window
|
Read-only | |
Implemented in | Navigator 4.0 |
pageYOffset
property provides the current y-position of a page as it relates to the upper-left corner of the window's content area. This property is useful when you need to find the current location of the scrolled page before using scrollTo
or scrollBy
. x = myWindow.pageYOffset
Window.pageXOffset
parent
property is the window or frame whose frameset contains the current frame.
Property of |
Window
|
Read-only | |
Implemented in | Navigator 2.0 |
The parent
property refers to the FRAMESET
window of a frame. Child frames within a frameset refer to sibling frames by using parent
in place of the window name in one of the following ways:
parent.frameNameFor example, if the fourth frame in a set has
parent.frames[index]
NAME="homeFrame"
, sibling frames can refer to that frame using parent.homeFrame
or parent.frames[3]
.
You can use parent.parent
to refer to the "grandparent" frame or window when a FRAMESET
tag is nested within a child frame.
The value of the parent
property is
<object nameAttribute>where
nameAttribute
is the NAME
attribute if the parent is a frame, or an internal reference if the parent is a window.Frame
.
Property of |
Window
|
Implemented in | Navigator 4.0 |
personalbar
property itself one property, visible
. If true, the personal bar is visible; if false, it is hidden.visible
property requires the UniversalBrowserWrite
privilege. For information on security in Navigator 4.0, see Chapter 7, "JavaScript Security," in the JavaScript Guide. self.menubar.visible=false;
self.toolbar.visible=false;
self.locationbar.visible=false;
self.personalbar.visible=false;
self.scrollbars.visible=false;
self.statusbar.visible=false;
Property of |
Window
|
Implemented in | Navigator 4.0 |
scrollbars
property itself has one property, visible
. If true, both scrollbars are visible; if false, they are hidden.visible
property requires the UniversalBrowserWrite
privilege. For information on security in Navigator 4.0, see Chapter 7, "JavaScript Security," in the JavaScript Guide. self.menubar.visible=false;
self.toolbar.visible=false;
self.locationbar.visible=false;
self.personalbar.visible=false;
self.scrollbars.visible=false;
self.statusbar.visible=false;
self
property is a synonym for the current window.
Property of |
Window
|
Read-only | |
Implemented in | Navigator 2.0 |
self
property refers to the current window. That is, the value of this property is a synonym for the object itself.
Use the self
property to disambiguate a window
property from a form or form element of the same name. You can also use the self
property to make your code more readable.
The value of the self
property is
<object nameAttribute>where
nameAttribute
is the NAME
attribute if self
refers to a frame, or an internal reference if self
refers to a window.self.status
is used to set the status
property of the current window. This usage disambiguates the status
property of the current window from a form or form element called status
within the current window.<A HREF=""
onClick="this.href=pickRandomURL()"
onMouseOver="self.status='Pick a random URL' ; return true">
Go!</A>
mouseOver
event occurs over an anchor.
Property of |
Window
|
Implemented in | Navigator 2.0 |
status
property with the defaultStatus
property. The defaultStatus
property reflects the default message displayed in the status bar.
You can set the status
property at any time. You must return true if you want to set the status
property in the onMouseOver
event handler.
pickRandomURL
that lets you select a URL at random. You can use the onClick
event handler of an anchor to specify a value for the HREF
attribute of the anchor dynamically, and the onMouseOver
event handler to specify a custom message for the window in the status
property:<A HREF=""In the preceding example, the
onClick="this.href=pickRandomURL()"
onMouseOver="self.status='Pick a random URL'; return true">
Go!</A>
status
property of the window is assigned to the window's self
property, as self.status
.Window.defaultStatus
Property of |
Window
|
Implemented in | Navigator 4.0 |
statusbar
property itself one property, visible
. If true, the status bar is visible; if false, it is hidden.visible
property requires the UniversalBrowserWrite
privilege. For information on security in Navigator 4.0, see Chapter 7, "JavaScript Security," in the JavaScript Guide. self.menubar.visible=false;
self.toolbar.visible=false;
self.locationbar.visible=false;
self.personalbar.visible=false;
self.scrollbars.visible=false;
self.statusbar.visible=false;
Property of |
Window
|
Implemented in | Navigator 4.0 |
toolbar
property itself one property, visible
. If true, the tool bar is visible; if false, it is hidden.visible
property requires the UniversalBrowserWrite
privilege. For information on security in Navigator 4.0, see Chapter 7, "JavaScript Security," in the JavaScript Guide. self.menubar.visible=false;
self.toolbar.visible=false;
self.locationbar.visible=false;
self.personalbar.visible=false;
self.scrollbars.visible=false;
self.statusbar.visible=false;
top
property is a synonym for the topmost browser window, which is a document window or web browser window.
Property of |
Window
|
Read-only | |
Implemented in | Navigator 2.0 |
top
property refers to the topmost window that contains frames or nested framesets. Use the top
property to refer to this ancestor window.
The value of the top
property is
<object objectReference>where
objectReference
is an internal reference.top.close()
closes the topmost ancestor window.
The statement top.length
specifies the number of frames contained within the topmost ancestor window. When the topmost ancestor is defined as follows, top.length
returns three:
<FRAMESET COLS="30%,40%,30%">The following example sets the background color of a frame called
<FRAME SRC=child1.htm NAME="childFrame1">
<FRAME SRC=child2.htm NAME="childFrame2">
<FRAME SRC=child3.htm NAME="childFrame3">
</FRAMESET>
myFrame
to red. myFrame
is a child of the topmost ancestor window.top.myFrame.document.bgColor="red"
window
property is a synonym for the current window or frame.
Property of |
Window
|
Read-only | |
Implemented in | Navigator 2.0 |
window
property refers to the current window or frame. That is, the value of this property is a synonym for the object itself.
Although you can use the window
property as a synonym for the current frame, your code may be more readable if you use the self
property. For example, window.name
and self.name
both specify the name of the current frame, but self.name
may be easier to understand (because a frame is not displayed as a separate window).
The value of the window
property is
<object nameAttribute>where
nameAttribute
is the NAME
attribute if window
refers to a frame, or an internal reference if window
refers to a window.window.status
is used to set the status
property of the current window. This usage disambiguates the status
property of the current window from a form called "status" within the current window.<A HREF=""
onClick="this.href=pickRandomURL()"
onMouseOver="window.status='Pick a random URL' ; return true">
Go!</A>
Window.self
Method of |
Window
|
Implemented in | Navigator 2.0 |
alert("message")
message | A string. |
Use the alert
method to display a message that does not require a user decision. The message
argument specifies a message that the dialog box contains.
You cannot specify a title for an alert dialog box, but you can use the open
method to create your own alert dialog box. See open
.
testValue
function checks the name entered by a user in the Text
object of a form to make sure that it is no more than eight characters in length. This example uses the alert
method to prompt the user to enter a valid value.function testValue(textElement) {You can call the
if (textElement.length > 8) {
alert("Please enter a name that is 8 characters or less")
}
}
testValue
function in the onBlur
event handler of a form's Text
object, as shown in the following example:Name: <INPUT TYPE="text" NAME="userName"
onBlur="testValue(userName.value)">
Window.confirm
, Window.prompt
Method of |
Window
|
Implemented in | Navigator 4.0 |
back()
back
method is equivalent to the user pressing the browser's Back button. That is, back
undoes the last step anywhere within the top-level window, whether it occurred in the same frame or in another frame in the tree of frames loaded from the top-level window. In contrast, the history
object's back
method backs up the current window or frame history one step.
For example, consider the following scenario. While in Frame A, you click the Forward button to change Frame A's content. You then move to Frame B and click the Forward button to change Frame B's content. If you move back to Frame A and call FrameA.back()
, the content of Frame B changes (clicking the Back button behaves the same).
If you want to navigate Frame A separately, use FrameA.history.back()
.
<P><INPUT TYPE="button" VALUE="< Go Back"
onClick="history.back()">
<P><INPUT TYPE="button" VALUE="> Go Back"
onClick="myWindow.back()">
Window.forward
, History.back
Method of |
Window
|
Implemented in | Navigator 2.0 |
blur()
blur
method to remove focus from a specific window or frame. Removing focus from a window sends the window to the background in most windowing systems.Window.focus
Method of |
Window
|
Implemented in | Navigator 4.0 |
captureEvents(eventType)
eventType |
The type of event to be captured. The available event types are listed with the event object.
|
captureEvents
in a signed script
and precede it with enableExternalCapture
. You must have the
UniversalBrowserWrite
privilege. For more information and an example, see
enableExternalCapture
. For information on security in Navigator 4.0, see
Chapter 7, "JavaScript Security," in the JavaScript Guide.
captureEvents
works in tandem with releaseEvents
, routeEvent
, and
handleEvent
. For more information, see "Events in Navigator 4.0".
setInterval
method.
Method of |
Window
|
Implemented in | Navigator 4.0 |
clearInterval(intervalID)
intervalID |
Timeout setting that was returned by a previous call to the setInterval method.
|
setInterval
.setInterval
.Window.setInterval
setTimeout
method.
Method of |
Window
|
Implemented in | Navigator 2.0 |
clearTimeout(timeoutID)
timeoutID |
A timeout setting that was returned by a previous call to the setTimeout method.
|
setTimeout
.setTimeout
.Window.clearInterval
, Window.setTimeout
Method of |
Window
|
Implemented in |
Navigator 2.0: closes any window. Navigator 3.0: closes only windows opened by JavaScript. Navigator 4.0: must use signed scripts to unconditionally close a window. |
close()
UniversalBrowserWrite
privilege. For information on security in Navigator 4.0, see Chapter 7, "JavaScript Security," in the JavaScript Guide. close
method closes the specified window. If you call close
without specifying a windowReference
, JavaScript closes the current window.
The close
method closes only windows opened by JavaScript using the open
method. If you attempt to close any other window, a confirm is generated, which lets the user choose whether the window closes. This is a security feature to prevent "mail bombs" containing self.close()
. However, if the window has only one document (the current one) in its session history, the close is allowed without any confirm. This is a special case for one-off windows that need to open other windows and then dispose of themselves.
window.close()Example 2: Close the main browser window. The following code closes the main browser window.
self.close()
close()
top.opener.close()Example 3. The following example closes the
messageWin
window:messageWin.close()This example assumes that the window was opened in a manner similar to the following:
messageWin=window.open("")
Window.closed
, Window.open
Method of |
Window
|
Implemented in | Navigator 2.0 |
confirm("message")
message | A string. |
Use the confirm
method to ask the user to make a decision that requires either an OK or a Cancel. The message
argument specifies a message that prompts the user for the decision. The confirm
method returns true if the user chooses OK and false if the user chooses Cancel.
You cannot specify a title for a confirm dialog box, but you can use the open
method to create your own confirm dialog. See open
.
confirm
method in the confirmCleanUp
function to confirm that the user of an application really wants to quit. If the user chooses OK, the custom cleanUp
function closes the application.function confirmCleanUp() {You can call the
if (confirm("Are you sure you want to quit this application?")) {
cleanUp()
}
}
confirmCleanUp
function in the onClick
event handler of a form's push button, as shown in the following example:<INPUT TYPE="button" VALUE="Quit" onClick="confirmCleanUp()">
Window.alert
, Window.prompt
enableExternalCapture
method.
Method of |
Window
|
Implemented in | Navigator 4.0 |
disableExternalCapture()
enableExternalCapture
.
Method of |
Window
|
Implemented in | Navigator 4.0 |
enableExternalCapture()
UniversalBrowserWrite
privileges, and use it before calling the captureEvents
method.
If Communicator sees additional scripts that cause the set of principals in effect for the container to be downgraded, it disables external capture of events. Additional calls to enableExternalCapture
(after acquiring the UniversalBrowserWrite
privilege under the reduced set of principals) can be made to enable external capture again.
Click
events that occur across its frames. <SCRIPT ARCHIVE="myArchive.jar" ID="2">
function captureClicks() {
netscape.security.PrivilegeManager.enablePrivilege(
"UniversalBrowserWrite");
enableExternalCapture();
captureEvents(Event.CLICK);
...
}
</SCRIPT>
Window.disableExternalCapture
, Window.captureEvents
Method of |
Window
|
Implemented in | Navigator 4.0 |
find(string, casesensitive, backward)
Method of |
Window
|
Implemented in | Navigator 3.0 |
focus()
focus
method to navigate to a specific window or frame, and give it focus. Giving focus to a window brings the window forward in most windowing systems.
In Navigator 3.0, on some platforms, the focus
method gives focus to a frame but the focus is not visually apparent (for example, the frame's border is not darkened).
checkPassword
function confirms that a user has entered a valid password. If the password is not valid, the focus
method returns focus to the Password
object and the select
method highlights it so the user can reenter the password.function checkPassword(userPass) {This example assumes that the
if (badPassword) {
alert("Please enter your password again.")
userPass.focus()
userPass.select()
}
}
Password
object is defined as<INPUT TYPE="password" NAME="userPass">
Window.blur
Method of |
Window
|
Implemented in | Navigator 4.0 |
history.forward()
forward()
forward
method is the same as history.go(1)
.
When used with the Frame object, forward
behaves as follows: While in Frame A, you click the Back button to change Frame A's content. You then move to Frame B and click the Back button to change Frame B's content. If you move back to Frame A and call FrameA.forward()
, the content of Frame B changes (clicking the Forward button behaves the same). If you want to navigate Frame A separately, use FrameA.history.forward()
.
<P><INPUT TYPE="button" VALUE="< Go Forth"
onClick="history.forward()">
<P><INPUT TYPE="button" VALUE="> Go Forth"
onClick="myWindow.forward()">
Window.back
Method of |
Window
|
Implemented in | Navigator 4.0 |
handleEvent(event)
event | The name of an event for which the specified object has an event handler. |
handleEvent
works in tandem with captureEvents
, releaseEvents
, and
routeEvent
. For more information, see "Events in Navigator 4.0".
Method of |
Window
|
Implemented in | Navigator 4.0 |
home()
Method of |
Window
|
Implemented in | Navigator 4.0 |
moveBy(horizontal, vertical)
horizontal | The number of pixels by which to move the window horizontally. |
vertical | The number of pixels by which to move the window vertically. |
UniversalBrowserWrite
privilege for this. For information on security in Navigator 4.0, see Chapter 7, "JavaScript Security," in the JavaScript Guide. self.moveBy(-5,10); // relative positioning
Window.moveTo
Method of |
Window
|
Implemented in | Navigator 4.0 |
moveTo(x-coordinate, y-coordinate)
x-coordinate | The left edge of the window in screen coordinates. |
y-coordinate | The top edge of the window in screen coordinates. |
UniversalBrowserWrite
privilege for this. For information on security in Navigator 4.0, see Chapter 7, "JavaScript Security," in the JavaScript Guide. self.moveTo(25,10); // absolute positioning
Window.moveBy
Method of |
Window
|
Implemented in |
Navigator 2.0 Navigator 4.0: added several new windowFeatures
|
open(URL, windowName, windowFeatures)
URL |
A string specifying the URL to open in the new window. See the Location object for a description of the URL components.
|
windowName |
A string specifying the window name to use in the TARGET attribute of a FORM or A tag. windowName can contain only alphanumeric or underscore (_) characters.
|
windowFeatures | (Optional) A string containing a comma-separated list determining whether or not to create various standard window features. These options are described below. |
window.open()
instead of simply using open()
. Due to the scoping of static objects in JavaScript, a call to open()
without specifying an object name is equivalent to document.open()
.
The open
method opens a new Web browser window on the client, similar to choosing New Navigator Window from the File menu of the browser. The URL
argument specifies the URL contained by the new window. If URL
is an empty string, a new, empty window is created.
open("", "messageWindow", "toolbar")The following statement turn on the location and directories options and turns off all other Boolean options:
open("", "messageWindow", "toolbar=yes")
open("", "messageWindow", "toolbar=1")
open("", "messageWindow", "toolbar,directories=yes")How the
alwaysLowered
, alwaysRaised
, and z-lock
features behave depends on the windowing hierarchy of the platform. For example, on Windows, an alwaysLowered
or z-locked
browser window is below all windows in all open applications. On Macintosh, an alwaysLowered
browser window is below all browser windows, but not necessarily below windows in other open applications. Similarly for an alwaysRaised
window.
You may use open
to open a new window and then use open
on that window to open another window, and so on. In this way, you can end up with a chain of opened windows, each of which has an opener
property pointing to the window that opened it.
Communicator allows a maximum of 100 windows to be around at once. If you open window2
from window1
and then are done with window1
, be sure to set the opener
property of window2
to null
. This allows JavaScript to garbage collect window1
. If you do not set the opener
property to null
, the window1
object remains, even though it's no longer really needed.
UniversalBrowserWrite
privilege: innerWidth
, innerHeight
, outerWidth
, and outerHeight
. screenX
and screenY
. titlebar
. alwaysRaised
, alwaysLowered
, or z-lock
for any setting.windowOpener
function opens a window and uses write
methods to display a message:function windowOpener() {Example 2. The following is an
msgWindow=window.open("","displayWindow","menubar=yes")
msgWindow.document.write
("<HEAD><TITLE>Message window</TITLE></HEAD>")
msgWindow.document.write
("<CENTER><BIG><B>Hello, world!</B></BIG></CENTER>")
}
onClick
event handler that opens a new client window displaying the content specified in the file sesame.html
. The window opens with the specified option settings; all other options are false because they are not specified.<FORM NAME="myform">
<INPUT TYPE="button" NAME="Button1" VALUE="Open Sesame!"
onClick="window.open ('sesame.html', 'newWin',
'scrollbars=yes,status=yes,width=300,height=300')">
</FORM>
Window.close
Method of |
Window
|
Implemented in | Navigator 4.0 |
print()
Method of |
Window
|
Implemented in | Navigator 2.0 |
prompt(message, inputDefault)
message | A string to be displayed as the message. |
inputDefault | (Optional) A string or integer representing the default value of the input field. |
Use the prompt
method to display a dialog box that receives user input. If you do not specify an initial value for inputDefault
, the dialog box displays <undefined>
.
You cannot specify a title for a prompt dialog box, but you can use the open
method to create your own prompt dialog. See open
.
prompt("Enter the number of cookies you want to order:", 12)
Window.alert
, Window.confirm
Method of |
Window
|
Implemented in | Navigator 4.0 |
releaseEvents(eventType)
eventType | Type of event to be captured. |
releaseEvents
works in tandem with captureEvents
, routeEvent
, and handleEvent
. For more information, see "Events in Navigator 4.0".
Method of |
Window
|
Implemented in | Navigator 4.0 |
resizeBy(horizontal, vertical)
horizontal | The number of pixels by which to resize the window horizontally. |
vertical | The number of pixels by which to resize the window vertically. |
outerWidth
and outerHeight
properties. The upper left-hand corner remains anchored and the lower right-hand corner moves. resizeBy
moves the window by adding or subtracting the specified number of pixels to that corner's current location. UniversalBrowserWrite
privilege for this. For information on security in Navigator 4.0, see Chapter 7, "JavaScript Security," in the JavaScript Guide. self.resizeBy(-5,10); // relative positioning
Window.resizeTo
Method of |
Window
|
Implemented in | Navigator 4.0 |
resizeTo(outerWidth, outerHeight)
outerWidth | An integer representing the window's width in pixels. |
outerHeight | An integer representing the window's height in pixels. |
outerWidth
and outerHeight
properties. The upper left-hand corner remains anchored and the lower right-hand corner moves. resizeBy
moves to the specified position. The origin of the axes is at absolute position (0,0); this is the upper left-hand corner of the display.UniversalBrowserWrite
privilege for this. For information on security in Navigator 4.0, see Chapter 7, "JavaScript Security," in the JavaScript Guide. self.resizeTo(225,200); // absolute positioning
Window.resizeBy
Method of |
Window
|
Implemented in | Navigator 4.0 |
routeEvent(event)
event | Name of the event to be routed. |
routeEvent
works in tandem with captureEvents
, releaseEvents
, and handleEvent
. For more information, see "Events in Navigator 4.0".
Method of |
Window
|
Implemented in | Navigator 3.0; deprecated in 4.0 |
scroll
is no longer used and has been replaced by
scrollTo
. scrollTo
extends the capabilities of scroll
. scroll
remains for
backward compatibility.
Method of |
Window
|
Implemented in | Navigator 4.0 |
scrollBy(horizontal, vertical)
horizontal | The number of pixels by which to scroll the viewing area horizontally. |
vertical | The number of pixels by which to scroll the viewing area vertically. |
scrollBy
scrolls the window by adding or subtracting the specified number of pixels to the current scrolled location.
For this method to have an effect the visible
property of Window.scrollbars
must be true.
self.scrollBy(-5,30); // relative positioning
Window.scrollTo
Method of |
Window
|
Implemented in | Navigator 4.0 |
scrollTo(x-coordinate, y-coordinate)
x-coordinate | An integer representing the x-coordinate of the viewing area in pixels. |
y-coordinate | An integer representing the y-coordinate of the viewing area in pixels. |
scrollTo
replaces scroll
. scroll
remains for backward compatibility.
The scrollTo
method scrolls the content in the window if portions that can't be seen exist outside of the window. For this method to have an effect the visible
property of Window.scrollbars
must be true.
self.scrollTo(0,20); // absolute positioningExample 2: Scroll a different viewing area. The following code, which exists in one frame, scrolls the viewing area of a second frame. Two
Text
objects let the user specify the x and y coordinates. When the user clicks the Go button, the document in frame2
scrolls to the specified coordinates.<SCRIPT>
function scrollIt(form) {
var x = parseInt(form.x.value)
var y = parseInt(form.y.value)
parent.frame2.scrollTo(x, y)
}
</SCRIPT>
<BODY>
<FORM NAME="myForm">
<P><B>Specify the coordinates to scroll to:</B>
<BR>Horizontal:
<INPUT TYPE="text" NAME=x VALUE="0" SIZE=4>
<BR>Vertical:
<INPUT TYPE="text" NAME=y VALUE="0" SIZE=4>
<BR><INPUT TYPE="button" VALUE="Go"
onClick="scrollIt(document.myForm)">
</FORM>
Window.scrollBy
clearInterval
.
Method of |
Window
|
Implemented in | Navigator 4.0 |
setInterval(expression, msec)
setInterval(function, msec, arg1, ..., argN)
clearInterval
method. Window.clearInterval
, Window.setTimeout
Method of |
Window
|
Implemented in |
Navigator 2.0: Evaluating an expression. Navigator 4.0: Calling a function. |
setTimeout(expression, msec)
setTimeout(function, msec, arg1, ..., argN)
setTimeout
method evaluates an expression or calls a function after a specified amount of time. It does not act repeatedly. For example, if a setTimeout
method specifies five seconds, the expression is evaluated or the function is called after five seconds, not every five seconds. For repetitive timeouts, use the setInterval
method.
setTimeout
does not stall the script. The script continues immediately (not waiting for the timeout to expire). The call simply schedules an additional future event.
<SCRIPT LANGUAGE="JavaScript">Example 2. The following example displays the current time in a
function displayAlert() {
alert("5 seconds have elapsed since the button was clicked.")
}
</SCRIPT>
<BODY>
<FORM>
Click the button on the left for a reminder in 5 seconds;
click the button on the right to cancel the reminder before
it is displayed.
<P>
<INPUT TYPE="button" VALUE="5-second reminder"
NAME="remind_button"
onClick="timerID=setTimeout('displayAlert()',5000)">
<INPUT TYPE="button" VALUE="Clear the 5-second reminder"
NAME="remind_disable_button"
onClick="clearTimeout(timerID)">
</FORM>
</BODY>
Text
object. The showtime
function, which is called recursively, uses the setTimeout
method to update the time every second.<HEAD>
<SCRIPT LANGUAGE="JavaScript">
<!--
var timerID = null
var timerRunning = false
function stopclock(){
if(timerRunning)
clearTimeout(timerID)
timerRunning = false
}
function startclock(){
// Make sure the clock is stopped
stopclock()
showtime()
}
function showtime(){
var now = new Date()
var hours = now.getHours()
var minutes = now.getMinutes()
var seconds = now.getSeconds()
var timeValue = "" + ((hours > 12) ? hours - 12 : hours)
timeValue += ((minutes < 10) ? ":0" : ":") + minutes
timeValue += ((seconds < 10) ? ":0" : ":") + seconds
timeValue += (hours >= 12) ? " P.M." : " A.M."
document.clock.face.value = timeValue
timerID = setTimeout("showtime()",1000)
timerRunning = true
}
//-->
</SCRIPT>
</HEAD>
<BODY onLoad="startclock()">
<FORM NAME="clock" onSubmit="0">
<INPUT TYPE="text" NAME="face" SIZE=12 VALUE ="">
</FORM>
</BODY>
Window.clearTimeout
, Window.setInterval
Method of |
Window
|
Implemented in | Navigator 4.0 |
stop()
Last Updated: 10/31/97 16:29:51