<html>
<link rel="stylesheet" href="josh.css">
<body bgcolor="#FFFFFF">
<div id="Description">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">document</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
The <span class="literal">document</span> object represents both the content
viewed in the browser window or frame and the other content of the
HTML file loaded into the window or frame. Thus, all information from
the <span class="literal">head</span> portion of the file is also part of the <span class="literal">document</span> object. All references to elements must
include a reference to the <span class="literal">document</span> object. The <span class="literal">document</span> object has no name other than its
hard-wired object name: <span class="literal">document</span>.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2"><p>
For a browser with internal architecture based closely on the W3C
DOM, this <span class="literal">document</span> object represents the <span class="literal">HTMLDocument</span> objecta special kind (internal
subclass) of the core module's <span class="literal">Document</span> object, suited to holding HTML documents.
In other words, the <span class="literal">HTMLDocument</span> object inherits
the properties and methods of the core <span class="literal">Document</span> object (sharing facilities with XML documents) and gets additional
properties and methods that apply only to HTML documents. Of course,
there is the conceptual incongruity about whether an <span class="literal">HTMLDocument</span> is applicable to an XHTML document
because such a document theoretically is an XML document. But, in
practice, even an XHTML document becomes an HTML document for
scripting purposes, and has all the <span class="literal">HTMLDocument</span> properties and methods available to it.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2"><p>
One more important practical side to a W3C DOM implementation (as
evidenced by the Netscape 6 implementation) is that the <span class="literal">document</span> object internally implements
document-level properties and methods from other DOM modules, such as
views, events, and styles. Each of these modules defines an object
(<span class="literal">DocumentEvent</span>, <span class="literal">DocumentRange</span>, <span class="literal">DocumentStyle</span>, and <span class="literal">DocumentView</span>) that provides a vital connection
between the <span class="literal">HTMLDocument</span> and these add-on module
features. Thus, it is the <span class="literal">styleSheets</span> property of
the <span class="literal">DocumentStyle</span> object in the W3C DOM that the
scriptable <span class="literal">document</span> object described here uses to
reach the <span class="literal">styleSheet</span> objects and their rules. And
the <span class="literal">DocumentEvent</span> object links in its <span class="literal">createEvent( )</span> method that allows the scriptable <span class="literal">document</span> object to generate an event outside the
normal user- or system-created events. All of these features become
subsumed by the <span class="literal">document</span> object you reference and
script in Netscape 6 and similar browsers. The precise source module
for a particular feature is not important to the scripterall
you need to know is that the properties and methods belong to the
scriptable <span class="literal">document</span> object.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="objectmodelreference"><span class="title">Object Model Reference</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>[window.]document</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="objectspecificproperties"><span class="title">Object-Specific Properties</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><table border="1">
<tbody>
<tr>
<td><span class="literal">activeElement</span></td>
<td><span class="literal">alinkColor</span></td>
<td><span class="literal">anchors[ ]</span></td>
<td><span class="literal">applets[ ]</span></td>
</tr>
<tr>
<td><span class="literal">bgColor</span></td>
<td><span class="literal">body</span></td>
<td><span class="literal">charset</span></td>
<td><span class="literal">characterSet</span></td>
</tr>
<tr>
<td><span class="literal">compatMode</span></td>
<td><span class="literal">cookie</span></td>
<td><span class="literal">defaultCharset</span></td>
<td><span class="literal">defaultView</span></td>
</tr>
<tr>
<td><span class="literal">doctype</span></td>
<td><span class="literal">documentElement</span></td>
<td><span class="literal">domain</span></td>
<td><span class="literal">embeds[ ]</span></td>
</tr>
<tr>
<td><span class="literal">expando</span></td>
<td><span class="literal">fgColor</span></td>
<td><span class="literal">fileCreatedDate</span></td>
<td><span class="literal">fileModifiedDate</span></td>
</tr>
<tr>
<td><span class="literal">fileSize</span></td>
<td><span class="literal">fileUpdatedDate</span></td>
<td><span class="literal">forms[ ]</span></td>
<td><span class="literal">frames[ ]</span></td>
</tr>
<tr>
<td><span class="literal">height</span></td>
<td><span class="literal">ids[ ]</span></td>
<td><span class="literal">images[ ]</span></td>
<td><span class="literal">implementation</span></td>
</tr>
<tr>
<td><span class="literal">lastModified</span></td>
<td><span class="literal">layers[ ]</span></td>
<td><span class="literal">linkColor</span></td>
<td><span class="literal">links[ ]</span></td>
</tr>
<tr>
<td><span class="literal">location</span></td>
<td><span class="literal">media</span></td>
<td><span class="literal">mimeType</span></td>
<td><span class="literal">nameProp</span></td>
</tr>
<tr>
<td><span class="literal">namespaces[ ]</span></td>
<td><span class="literal">parentWindow</span></td>
<td><span class="literal">plugins[ ]</span></td>
<td><span class="literal">protocol</span></td>
</tr>
<tr>
<td><span class="literal">readyState</span></td>
<td><span class="literal">referrer</span></td>
<td><span class="literal">scripts[ ]</span></td>
<td><span class="literal">security</span></td>
</tr>
<tr>
<td><span class="literal">selection</span></td>
<td><span class="literal">styleSheets[ ]</span></td>
<td><span class="literal">tags[ ]</span></td>
<td><span class="literal">title</span></td>
</tr>
<tr>
<td><span class="literal">URL</span></td>
<td><span class="literal">URLUnencoded</span></td>
<td><span class="literal">vlinkColor</span></td>
<td><span class="literal">width</span></td>
</tr>
</tbody>
</table></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="objectspecificmethods"><span class="title">Object-Specific Methods</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><table border="1">
<tbody>
<tr>
<td><span class="literal">addBinding( )</span></td>
<td><span class="literal">captureEvents( )</span></td>
</tr>
<tr>
<td><span class="literal">clear( )</span></td>
<td><span class="literal">close( )</span></td>
</tr>
<tr>
<td><span class="literal">createAttribute( )</span></td>
<td><span class="literal">createAttributeNS( )</span></td>
</tr>
<tr>
<td><span class="literal">createCDATASection( )</span></td>
<td><span class="literal">createComment( )</span></td>
</tr>
<tr>
<td><span class="literal">createDocumentFragment( )</span></td>
<td><span class="literal">createElement( )</span></td>
</tr>
<tr>
<td><span class="literal">createElementNS( )</span></td>
<td><span class="literal">createEntityReference( )</span></td>
</tr>
<tr>
<td><span class="literal">createEvent( )</span></td>
<td><span class="literal">createEventObject( )</span></td>
</tr>
<tr>
<td><span class="literal">createNodeIterator( )</span></td>
<td><span class="literal">createProcessingInstruction( )</span></td>
</tr>
<tr>
<td><span class="literal">createRange( )</span></td>
<td><span class="literal">createStyleSheet( )</span></td>
</tr>
<tr>
<td><span class="literal">createTextNode( )</span></td>
<td><span class="literal">createTreeWalker( )</span></td>
</tr>
<tr>
<td><span class="literal">elementFromPoint( )</span></td>
<td><span class="literal">execCommand( )</span></td>
</tr>
<tr>
<td><span class="literal">getAnonymousElementByAttribute( )</span></td>
<td><span class="literal">getAnonymousNodes( )</span></td>
</tr>
<tr>
<td><span class="literal">getBindingParent( )</span></td>
<td><span class="literal">getElementById( )</span></td>
</tr>
<tr>
<td><span class="literal">getElementsByName( )</span></td>
<td><span class="literal">getSelection( )</span></td>
</tr>
<tr>
<td><span class="literal">handleEvent[ ]</span></td>
<td><span class="literal">hasFocus( )</span></td>
</tr>
<tr>
<td><span class="literal">importNode( )</span></td>
<td><span class="literal">loadBindingDocument( )</span></td>
</tr>
<tr>
<td><span class="literal">open( )</span></td>
<td><span class="literal">queryCommandEnabled( )</span></td>
</tr>
<tr>
<td><span class="literal">queryCommandIndeterm( )</span></td>
<td><span class="literal">queryCommandState( )</span></td>
</tr>
<tr>
<td><span class="literal">queryCommandSupported( )</span></td>
<td><span class="literal">queryCommandText( )</span></td>
</tr>
<tr>
<td><span class="literal">queryCommandValue( )</span></td>
<td><span class="literal">recalc( )</span></td>
</tr>
<tr>
<td><span class="literal">releaseEvents( )</span></td>
<td><span class="literal">removeBinding( )</span></td>
</tr>
<tr>
<td><span class="literal">routeEvent( )</span></td>
<td><span class="literal">write( )</span></td>
</tr>
<tr>
<td><span class="literal">writeln( )</span></td>
<td></td>
</tr>
</tbody>
</table></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="objectspecificeventhandlerproperties"><span class="title">Object-Specific Event Handler Properties</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><table border="1">
<tbody>
<th>Handler</th>
<th>NN</th>
<th>IE</th>
<th>DOM</th>
<tr>
<td>onselectionchange</td>
<td>n/a</td>
<td>4</td>
<td>n/a</td>
</tr>
<tr>
<td>onstop</td>
<td>n/a</td>
<td>4</td>
<td>n/a</td>
</tr>
</tbody>
</table></td>
</tr>
</table>
</div>
<div id="activeElement">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">activeElement</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Refers to the object that is currently designated as the active
element in the document. To learn more about the returned object,
you'll need to examine the object's <span class="literal">tagName</span>, <span class="literal">id</span>, or other
properties. Because buttons and other elements do not receive focus
on the IE 4 for Macintosh, the returned value of this property may
vary with operating system. While an element (especially a form
control) that receives focus also becomes active, an element might be
active, but due to other settings in newer IE versions, does not have
focus. See the shared <span class="literal">setActive( )</span> method.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var currObj = document.activeElement;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Element object reference.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="alinkColor">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">alinkColor</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read/Write (IE)</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Specifies the color of a hypertext link as it is being clicked. The
color is applied to the link text or border around an image or object
embedded within an <span class="literal">a</span> element. See also <span class="literal">linkColor</span> and <span class="literal">vlinkColor</span> properties for unvisited and visited link colors. Replaced in the W3C
DOM by the <span class="literal">aLink</span> property of the <span class="literal">body</span> object, which is supported in IE 4 and later
and in Netscape 6. Dynamically changed values for <span class="literal">alinkColor</span> are not reflected on the page in
Navigator through Version 4.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>document.alinkColor = "green";</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
A hexadecimal triplet or plain-language color name. See Appendix A for acceptable plain-language color names.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">#0000FF</span>
</p></td>
</tr>
</table>
</div>
<div id="anchors[ ]">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">anchors[ ]</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns an array of all <span class="literal">anchor</span> objects in the
current document. This includes <span class="literal">a</span> elements that
are designed as either anchors or combination anchors and links.
Items in this array are indexed (zero-based) in source code order.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var aCount = document.anchors.length;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of <span class="literal">anchor</span> element objects.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of length zero.
</p></td>
</tr>
</table>
</div>
<div id="applets[ ]">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">applets[ ]</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns an array of all Java <span class="literal">applet</span> objects in the
current document. An applet must be started and running before it is
counted as an object. Items in this array are indexed (zero-based) in
source code order.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var appletCount = document.applets.length</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of <span class="literal">applet</span> element objects.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of length zero.
</p></td>
</tr>
</table>
</div>
<div id="bgColor">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">bgColor</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read/Write</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Provides the background color of the document. Even if the <span class="literal">bgcolor</span> attribute or <span class="literal">bgColor</span> property is set with a plain-language color name, the returned value
is always a hexadecimal triplet.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2"><p>
Setting the <span class="literal">bgColor</span> property of a document in
Navigator 2 or 3 for Macintosh or Unix does not properly redraw the
window. Window content is obscured by the new color on those
platforms. For browsers that support the <span class="literal">document.body</span> object, use the <span class="literal">bgColor</span> property of that object instead.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>document.bgColor = "yellow";</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
A hexadecimal triplet or plain-language color name. See Appendix A for acceptable plain-language color names.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Varies with browser and operating system.
</p></td>
</tr>
</table>
</div>
<div id="body">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">body</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a reference to the <span class="literal">body</span> object defined by
the <span class="literal">body</span> element within the document. This
property is used as a gateway to the <span class="literal">body</span> object's properties.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>document.body.leftMargin = 15;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Object reference.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
The current <span class="literal">body</span> object.
</p></td>
</tr>
</table>
</div>
<div id="charset">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">charset</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read/Write</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Indicates the character encoding of the document's
content. This property is dropped from IE 6 for Windows in favor of
the <span class="literal">document.defaultCharset</span> property. For Netscape
6, use the <span class="literal">document.characterSet</span> property.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>if (document.charset == "csISO5427Cyrillic") {
    // process for Cyrillic charset
}</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Case-insensitive alias from the character set registry (ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets).
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Determined by browser.
</p></td>
</tr>
</table>
</div>
<div id="characterSet">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">characterSet</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Indicates the character encoding of the document's
content.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>if (document.characterSet == "ISO-8859-1") {
    // process for standard Latin character set
}</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Case-insensitive alias from the character set registry (ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets).
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Determined by browser.
</p></td>
</tr>
</table>
</div>
<div id="compatMode">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">compatMode</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">7</span> IE <span class="emphasis">6</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns the compatibility mode for the document, as controlled by the <span class="literal">DOCTYPE</span> element's content. See
the <span class="literal">DOCTYPE</span> element discussion in Chapter 8 for details on how to force the browser
to treat a document in either backward compatibility or standards
compatibility mode for element positioning and other implementation
details. Because the choice of mode can impact some style property
results, you can use this property to branch between two calculations
in a shared library so that they treat the current document
correctly, regardless of mode.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>if (document.compatMode == "BackCompat") {
    // process as if IE 5.5 or earlier or Netscape "quirks" mode
}</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
String constant: <span class="literal">BackCompat</span> | <span class="literal">CSS1Compat</span>.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">BackCompat</span>
</p></td>
</tr>
</table>
</div>
<div id="cookie">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">cookie</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read/Write</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Indicates the HTTP cookie associated with the domain of the document
and stored on the client machine. The Netscape browsers group all
cookie data together into a single file, while IE creates a separate
file for each domain's cookie data. Reading and
writing the <span class="literal">cookie</span> property are not parallel
operations. Reading a <span class="literal">cookie</span> property returns a
semicolon-delimited list of name/value pairs in the following format:
</p>
<span class="PROGRAMLISTING"><pre>name=value</pre></span>
</td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2"><p>
Up to 20 of these pairs can be stored in the cookie property for a
given domain (regardless of the number of HTML documents used in that
web site). A total of 4,000 characters can be stored in the cookie,
but it is advisable to keep each name/value pair to less than 2,000
characters in length. It is up to your scripting code to parse the <span class="literal">cookie</span> property value for an individually named
cookie's value.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2"><p>
Writing <span class="literal">cookie</span> property values allows more
optional pairs of data associated with a single name/value pair.
Cookie data must be a string, but you can deconstruct an array into a
string via the <span class="literal">Array.join( )</span> method for writing
the cookie value, and then use <span class="literal">String.split( )</span> to
reconstruct the array after reading the cookie data. The format is as
follows:
</p>
<span class="PROGRAMLISTING"><pre>document.cookie = &quot;<var class="replaceable">name</var>=<var class="replaceable">value</var>
    [; expires=<var class="replaceable">timeInGMT</var>]
    [; path=<var class="replaceable">pathName</var>]
    [; domain=<var class="replaceable">domainName</var>]
    [; secure]&quot;;</pre></span>
</td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2"><p>
No matter how many optional subproperties you set per cookie, only
the name/value pair may be retrieved. All cookie data written to the <span class="literal">cookie</span> property is maintained in the
browser's memory until the browser quits. If an
expiration date has been made part of the cookie data and that time
has not yet expired, the cookie data is saved to the actual cookie
file; otherwise, the cookie data is discarded. The browser
automatically deletes cookie data that has expired when the browser
next starts.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var exp = new Date( );
var nowPlusOneWeek = exp.getTime( ) + (7 * 24 * 60 * 60 * 1000);
exp.setTime(nowPlusOneWeek);
document.cookie = "userName=visitor; expires=" + exp.toGMTString( );</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Cookie data as string. See description.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="defaultCharset">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">defaultCharset</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Indicates the character encoding of the content of the document.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var cset = document.defaultCharset;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Case-insensitive alias from the character set registry (ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets).
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Determined by browser.
</p></td>
</tr>
</table>
</div>
<div id="defaultView">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">defaultView</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">2</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a reference to the W3C DOM abstract representation of a
"viewer" that renders the document
(the formal name for the object is <span class="literal">AbstractView</span>).
In Netscape 6, this object equates to the <span class="literal">window</span> or <span class="literal">frame</span> object that contains the document. A
script function that has access to a <span class="literal">document</span> object (such as via the element object's <span class="literal">ownerDocument</span> property) can obtain a valid
reference to the document's window via this <span class="literal">defaultView</span> property. The
document's view includes knowledge about cascaded
style rules applied to each element. See Chapter 4
for an example of obtaining the effective style of an element with
the help of the <span class="literal">document.defaultView</span> property and
the <span class="literal">getComputedStyle( )</span> method.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2"><p>
This is as close as the W3C DOM Level 2 comes to acknowledging the
existence of a <span class="literal">window</span> object. More is to come in
Level 3.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var theWin = elemRef.ownerDocument.defaultView;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Reference to a <span class="literal">window</span> object.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
The document's window.
</p></td>
</tr>
</table>
</div>
<div id="doctype">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">doctype</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">5(Mac)</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a reference to the <span class="literal">DOCTYPE</span> element object
(the same as the W3C DOM abstract <span class="literal">DocumentType</span> node object). The property returns a reference value only if the <span class="literal">DOCTYPE</span> is specified in the document; otherwise
the property returns <span class="literal">null</span>. As of Version 6, IE for
Windows does not implement this property or node type. See the <span class="literal">DocumentType</span> object for properties available in
various browsers. In a pure W3C DOM environment, the <span class="literal">doctype</span> property is inherited from the core <span class="literal">document</span> object, and is thus available to XML
documents, as well.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var docsType = document.doctype;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Node reference.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="documentElement">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">documentElement</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">5</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a reference to the root element node of the document. For
HTML documents, the reference is to the <span class="literal">html</span> element that encompasses the document's <span class="literal">head</span> and <span class="literal">body</span> elements. In a
pure W3C DOM environment, the <span class="literal">documentElement</span> property is inherited from the core <span class="literal">document</span> object, and is thus available to XML documents, as well.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var rootElem = document.documentElement;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Element node reference.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
The current <span class="literal">html</span> element object.
</p></td>
</tr>
</table>
</div>
<div id="domain">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">domain</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">3</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read/Write</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Provides the hostname of the server that served up the document. If
documents from different servers on the same domain must exchange
content with each other, the <span class="literal">domain</span> properties of
both documents must be set to the same domain to avoid security
restrictions. Normally, if the hosts don't match,
browser security disallows access to the other
document's form data. This property allows, for
example, a page from the <span class="emphasis">www</span> server to
communicate with a page served up by a secure server.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>document.domain = "megaCorp.com";</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
String of the domain name that two documents have in common
(exclusive of the server name).
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="embeds[ ]">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">embeds[ ]</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">3</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns an array of all embedded objects (<span class="literal">embed</span> elements) in the current document. Items in this array are indexed
(zero-based) in source code order.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var embedCount = document.embeds.length;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of embed object references.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of zero length.
</p></td>
</tr>
</table>
</div>
<div id="expando">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">expando</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read/Write</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Specifies whether scripts in the current document allow the creation
and use of custom properties assigned to the <span class="literal">document</span> object. The extensible nature of
JavaScript allows scripters to create a new object property by just
assigning a value to it (as in <span class="literal">document.stooge</span> <span class="literal">=</span> <span class="literal">"Curly"</span>). This also means the
document accepts incorrectly spelled property assignments, such as
forgetting to set a middle letter of a long property name to
uppercase (<span class="literal">marginLeftColor</span>). Such assignments are
accepted without question, but the desired result is nowhere to be
seen. If you don't intend to create custom
properties, consider setting <span class="literal">document.expando</span> to <span class="literal">false</span> in an opening script statement as you author
a page. This could help prevent spelling errors from causing bugs.
The setting affects only scripts in the current document.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>document.expando = false;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Boolean value: <span class="literal">true</span> | <span class="literal">false</span>.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">true</span>
</p></td>
</tr>
</table>
</div>
<div id="fgColor">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">fgColor</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read/Write</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Provides the foreground (text) color for the document. While you can
change this property in all versions of Navigator, the text does not
change dynamically in versions prior to 6. Still supported in current
browsers, this property is replaced in IE 4 and Netscape 6 by <span class="literal">document.body.text</span> or style sheet settings.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>document.fgColor = "darkred";</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
A hexadecimal triplet or plain-language color name. See Appendix A for acceptable plain-language color names.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Browser default (usually <span class="literal">black</span>).
</p></td>
</tr>
</table>
</div>
<div id="fileCreatedDate">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">fileCreatedDate</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a string of the date (but not the time) that the server (or
local filesystem) reports the currently-loaded file was created. IE
4's value is a long date format, but starting with
IE 5, the date information is formatted as mm/dd/yyyy. The value may
be corrupted if the server supplies the data in a format that IE does
not expect. Not implemented in IE Mac through Version 5.1.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var dateObj = new Date(document.fileCreatedDate);</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Date string.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="fileModifiedDate">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">fileModifiedDate</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a string of the date (but not the time) that the server (or
local file system) reports the currently-loaded file was most
recently modified. IE 4's value is a long date
format, but starting with IE 5, the date information is formatted as
mm/dd/yyyy. The value may be corrupted or incorrect if the server
supplies the data in a format that IE does not expect. Not
implemented in IE Mac through Version 5.1.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var dateObj = new Date(document.fileModifiedDate);</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Date string.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="fileSize">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">fileSize</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns the number of bytes for the size of the currently-loaded
document. IE for Windows returns this value as a string, while IE for
Macintosh returns a number value (an important distinction if you
need to perform math operations on the value).
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var byteCount = parseInt(document.fileSize, 10);</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Integer as string (Windows) or number (Mac).
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="fileUpdatedDate">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">fileUpdatedDate</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">5.5(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns an empty string. Apparently not officially supported for the <span class="literal">document</span> object.
</p></td>
</tr>
</table>
</div>
<div id="forms[ ]">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">forms[ ]</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns an array of all <span class="literal">form</span> objects
(<span class="literal">form</span> elements) in the current document. Items in
this array are indexed (zero-based) in source code order, but may
also be accessed by using the form's name as a
string index value.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var elemCount = document.forms[0].elements.length;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of <span class="literal">form</span> objects.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of zero length.
</p></td>
</tr>
</table>
</div>
<div id="frames[ ]">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">frames[ ]</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns an array of all <span class="literal">iframe</span> objects
(<span class="literal">iframe</span> element objects, not to be confused with
window-like <span class="literal">frame</span> objects) in the current
document. Items in this array are indexed (zero-based) in source code
order. For cross-compatibility with IE 5 and later and Netscape 6,
use <span class="literal">document.getElementsByTagName("iframe")</span> instead.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var iframeCount = document.frames.length;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of <span class="literal">iframe</span> objects.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of zero length.
</p></td>
</tr>
</table>
</div>
<div id="height, width">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">height, width</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">4</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Return the pixel dimensions of the entire rendered document. These
values coincide with the <span class="literal">offsetHeight</span> and <span class="literal">offsetWidth</span> property values for the <span class="literal">document.body</span> object. Since neither property
pairing is yet sanctioned by the W3C DOM, you might prefer the offset
pair, because they are at least cross-browser compatible.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var howTall = document.height;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Number of pixels.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Current document size.
</p></td>
</tr>
</table>
</div>
<div id="ids[ ]">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">ids[ ]</td>
<td valign="top" nowrap class="compatibility">NN |<span class="emphasis">4|</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Used with the Navigator 4-only JavaScript syntax of style sheets, the <span class="literal">ids[ ]</span> collection is part of a reference to a
single ID and the style property assigned to it in the syntax form <span class="literal">[document.]ids.</span><span class="replaceable">idName</span><span class="literal">.</span><span class="replaceable">stylePropertyName</span>.
For a list of related properties, see the <span class="literal">tags</span> object listing in this chapter.
</p></td>
</tr>
</table>
</div>
<div id="images[ ]">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">images[ ]</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns an array of all <span class="literal">img</span> element objects
(exclusive of pre-cached images loaded via the <span class="literal">new Image(
)</span> constructor) in the current document. Items in this array
are indexed (zero-based) in source code order, and may be accessed by
number or by string name. The presence of this property indicates
support for live, swappable images.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>document.images["home"].src = "images/homeHilite.jpg";</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of <span class="literal">img</span> objects.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of zero length.
</p></td>
</tr>
</table>
</div>
<div id="implementation">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">implementation</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">5(Mac)/6(Win)</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a reference to the W3C <span class="literal">DOMImplementation</span> object, which represents, to a limited degree, the environment that
makes up the document containerthe browser, for our purposes.
Methods of the object let you see which DOM modules the browser
reports supporting. This object is also a gateway to creating virtual
W3C <span class="literal">Document</span> and <span class="literal">DocumentType</span> objects outside of the current document tree. Thus, in Netscape 6 you
can use the <span class="literal">document.implementation</span> property as a
start to generating a nonrendered document for external XML
documents. See the <span class="literal">DOMImplementation</span> object for
details about the methods and their browser support.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var xDoc = document.implementation.createDocument("", "theXdoc", null);</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Reference to a <span class="literal">DOMImplementation</span> object.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Current <span class="literal">DOMImplementation</span> object.
</p></td>
</tr>
</table>
</div>
<div id="lastModified">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">lastModified</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Provides the date and time (as a string) on which the server says the
document file was last modified. Some servers don't
supply this information at all or correctly. Non-Windows browsers
also tend to have a rough time interpreting the information
correctly. Only in recent browsers is the date string in a form
suitable as a parameter for a <span class="literal">Date</span> object
constructor.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>document.write(document.lastModified);</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
String representation of a date and time.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="layers[ ]">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">layers[ ]</td>
<td valign="top" nowrap class="compatibility">NN |<span class="emphasis">4|</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns an array of all Navigator 4-only <span class="literal">layer</span> element objects in the current document. Also included in the array
are references to other HTML elements with style sheets that set the
element to be relative- or absolute-positioned (in which case,
Navigator 4 treats those elements as layer objects). Items in this
array are indexed (zero-based) in source code order, and may be
accessed by number or by string name. As a dead-end feature
implemented only in Navigator 4, the presence of this property
indicates support for the unique referencing requirements for
Netscape layers.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>if (document.layers) {
    // use document.layers[ ] syntax for references
}</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of <span class="literal">layer</span> objects or their equivalent.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of zero length.
</p></td>
</tr>
</table>
</div>
<div id="linkColor">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">linkColor</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read/Write</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Indicates the color of a hypertext link that has not been visited
(that is, the URL of the link is not in the
browser's cache). This is one of three states for a
link: unvisited, active, and visited. The color is applied to the
link text or border around an image or object embedded within an <span class="literal">a</span> element. Changes to this property do not
dynamically change the link color in Navigator 4 or earlier. Starting
with IE 4 and Netscape 6, you should switch to using the W3C DOM
alternative, <span class="literal">document.body.link</span>, or style sheets.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>document.link Color= "#00FF00";</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
A hexadecimal triplet or plain-language color name. See Appendix A for acceptable plain-language color names.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">#0000FF</span>
</p></td>
</tr>
</table>
</div>
<div id="location">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">location</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">&lt;6</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read/Write</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Indicates the URL of the current document. This property was
deprecated because it may conflict with the <span class="literal">window.location</span> property. Netscape 6 drops support
for this property entirely. Use either the <span class="literal">document.URL</span> property, or, better, the <span class="literal">window.location.href</span> property.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>document.location = "products/widget33.html";</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
A full or relative URL as a string.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Document URL.
</p></td>
</tr>
</table>
</div>
<div id="media">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">media</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">5.5(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read/Write</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a string indicating the output medium for which the content
is formatted. The property returns an empty string as of IE 6, and
throws a security error if you assign accepted string values
(<span class="literal">all</span>, <span class="literal">print</span>, or <span class="literal">screen</span>) to it. Avoid using this property with the <span class="literal">document</span> object.
</p></td>
</tr>
</table>
</div>
<div id="mimeType">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">mimeType</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">5(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a string indicating the basic document type, but not in a
MIME format. For an HTML document, the string returned changed
starting with IE 5.5 to <span class="literal">HTML Document</span>. Do not
confuse this <span class="literal">document</span> object property with the
Netscape and IE/Mac <span class="literal">navigator.mimeTypes</span> property,
which is an entirely different animal.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var what = document.mimeType;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
String.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
"HTML Document"
</p></td>
</tr>
</table>
</div>
<div id="nameProp">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">nameProp</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">6(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a string containing the same data as <span class="literal">document.title</span>, including an empty string if no <span class="literal">title</span> element exists in the document. This
property may not be officially supported for the <span class="literal">document</span> object.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
String.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Empty string.
</p></td>
</tr>
</table>
</div>
<div id="namespaces[ ]">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">namespaces[ ]</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">5.5(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a collection of IE <span class="literal">namespace</span> objects
implemented in the current document. A <span class="literal">namespace</span> object is a gateway to loading external behaviors. For more details,
visit http://msdn.microsoft.com/workshop/author/behaviors/overview/elementb_ovw.asp.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var IENSCount = document.namespaces.length;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of <span class="literal">namespace</span> object references.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of zero length.
</p></td>
</tr>
</table>
</div>
<div id="parentWindow">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">parentWindow</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a reference to the <span class="literal">window</span> object (which
may be a frame in a frameset) that contains the current document. Use
this reference to access the window's properties and
methods directly. The returned value is the same as the <span class="literal">window</span> reference from the document.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var siblingCount = document.parentWindow.frames.length;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">window</span> or <span class="literal">frame</span> object
reference.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">window</span> object.
</p></td>
</tr>
</table>
</div>
<div id="plugins[ ]">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">plugins[ ]</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">4</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns an array of all embedded objects (<span class="literal">embed</span> elements) in the current document. Items in this array are indexed
(zero-based) in source code order. Do not confuse this collection
with the <span class="literal">navigator.plugins</span> collection in Netscape
Navigator.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var embedCount = document.plugins.length;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of <span class="literal">embed</span> object references.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of zero length.
</p></td>
</tr>
</table>
</div>
<div id="protocol">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">protocol</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a plain-language string describing the protocol used to load
the current document. Unlike the <span class="literal">location.protocol</span> property's literal value (e.g., <span class="literal">http:</span> or <span class="literal">file:</span>), the <span class="literal">document.protocol</span> is human-readable (e.g., <span class="literal">Hypertext</span> <span class="literal">Transfer</span> <span class="literal">Protocol</span> or <span class="literal">File Protocol</span>).
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>if (document.protocol == "File Protocol") {
    // process for file access in IE
}</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Plain-language string.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Current document's protocol type.
</p></td>
</tr>
</table>
</div>
<div id="readyState">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">readyState</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns the current download status of the document content. If a
script (especially one initiated by a user event) can perform some
actions while the document is still loading, but must avoid other
actions until the entire page has loaded, this property provides
intermediate information about the loading process. You would use its
value in condition tests. The value of this property changes during
loading as the loading state changes. Each change of the property
value fires an <span class="literal">onreadystatechange</span> event.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>if (document.readyState == "loading") {
    // statements for alternate handling
}</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
One of the following values (as strings): <span class="literal">complete</span> | <span class="literal">interactive</span> | <span class="literal">loading</span> | <span class="literal">uninitialized</span>. Some elements may allow the user to
interact with partial content, in which case the property may return <span class="literal">interactive</span> until all loading has completed.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="referrer">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">referrer</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a string of the URL of the page from which the current page
was accessed, provided the original page had a link to the current
page. Many server logs capture this information as well. Scripts can
see whether the visitor reached the current document from specific
origins and perhaps present slightly different content on the page
accordingly. If the visitor arrived by another method, such as typing
the document URL into a browser dialog or by selecting a bookmark,
the <span class="literal">referrer</span> property returns an empty string.
Many versions of IE for Windows fail to report the correct referrer
URL, often showing the URL of the current page instead.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>if (document.referrer) {
    document.write("&lt;p&gt;Thanks for following the link to our web site.&lt;/p&gt;");
}</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
String.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="scripts[ ]">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">scripts[ ]</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns an array of all <span class="literal">script</span> objects
(<span class="literal">script</span> elements) in the current document. Each <span class="literal">script</span> object may contain any number of functions.
The <span class="literal">scripts[ ]</span> collection counts the number of
actual <span class="literal">&lt;script&gt;</span> tags in the document. Items
in this array are indexed (zero-based) in source code order.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var scriptCount = document.scripts.length;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of <span class="literal">script</span> element references.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of zero length.
</p></td>
</tr>
</table>
</div>
<div id="security">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">security</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">5.5(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a string describing the security policy in force for the
current document.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var secPolicy = document.security;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
String.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
"This type of document does not have a security
certificate."
</p></td>
</tr>
</table>
</div>
<div id="selection">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">selection</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a <span class="literal">selection</span> object. To work with text that
has been selected by the user or script, you must convert the
selection to a <span class="literal">TextRange</span> object. This is possible
only in Internet Explorer for Win32. Access to the Netscape 6
selection is via the <span class="literal">window.selection</span> property.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var range = document.selection.createRange( );</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Object reference.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="styleSheets[ ]">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">styleSheets[ ]</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">2</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns an array of all <span class="literal">styleSheet</span> objects in the
current document. Each style object may contain any number of style
sheet rules. The <span class="literal">styleSheets[ ]</span> collection counts
the number of actual <span class="literal">&lt;style&gt;</span> tags in the
document as well as <span class="literal">&lt;link&gt;</span> tags that load
external style sheet files. Items in this array are indexed
(zero-based) in source code order. An <span class="literal">@import</span> style sheet object is accessible via a <span class="literal">styleSheet</span> object's <span class="literal">cssRule.styleSheet</span> property. See the <span class="literal">styleSheet</span> object.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>for (var i = 0; i &lt; document.styleSheets.length; i++) {
    // loop through each styleSheet object
}</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of <span class="literal">styleSheet</span> object references.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of zero length.
</p></td>
</tr>
</table>
</div>
<div id="tags[ ]">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">tags[ ]</td>
<td valign="top" nowrap class="compatibility">NN |<span class="emphasis">4|</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Used with the Navigator 4-only JavaScript syntax of style sheets, the <span class="literal">tags[ ]</span> collection is part of a reference to a
single tag type and the style property assigned to it. For a list of
properties, see the <span class="literal">tags</span> object listing in this
chapter. Do not confuse this Navigator use of the <span class="literal">tags[ ]</span> collection with Internet
Explorer's use of the <span class="literal">tags[ ]</span> collection that belongs to the <span class="literal">all</span> collection.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>document.tags.H1.color= "red";</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of Navigator 4 JavaScript Style Sheet <span class="literal">tag</span> object references.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of zero length.
</p></td>
</tr>
</table>
</div>
<div id="title">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">title</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read/Write</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Unlike the <span class="literal">title</span> property for objects that reflect
HTML elements, the <span class="literal">document.title</span> property refers
to the content of the <span class="literal">title</span> element defined in the <span class="literal">head</span> portion of a document. The title content
appears in the browser's titlebar to help identify
the document. This is also the content that goes into a bookmark
listing for the page. Although the property is read/write,
don't be surprised if a browser version does not
alter the window titlebar in response.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>document.title = "Fred\'s Home Page";</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
String.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="URL">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">URL</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">3</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read/Write</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Provides the URL of the current document. The value is the same as <span class="literal">location.href</span>. The <span class="literal">document.URL</span> property evolved as a replacement for <span class="literal">document.location</span> to avoid potential confusion (by
scripters and JavaScript interpreter engines) between the <span class="literal">location</span> object and <span class="literal">document.location</span> property. To navigate to another
page, it is safest (for cross-browser and backward compatibility) to
assign a URL string value to the <span class="literal">location.href</span> property, rather than this document-centered property.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>document.URL = "http://www.megacorp.com";</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Complete or relative URL as a string.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
The current document's URL.
</p></td>
</tr>
</table>
</div>
<div id="URLUnencoded">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">URLUnencoded</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">5.5(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read-only</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns the URL of the current document, but with any URL-encoded
characters returned to their plain-language version (e.g., <span class="literal">%20</span> is converted to a space character). The
returned value is the same as if applying the JavaScript <span class="literal">decodeURI( )</span> function to <span class="literal">document.URL</span>.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>var straightPath = document.URLUnencoded;</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Complete or relative URL as a string.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
The current document's URL.
</p></td>
</tr>
</table>
</div>
<div id="vlinkColor">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">vlinkColor</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements">Read/Write (IE)</td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Color of a hypertext link that has been visited recently. The color
is applied to the link text or border around an image or object
embedded within an <span class="literal">a</span> element. See also <span class="literal">alinkColor</span> and <span class="literal">linkColor</span> properties for clicked and unvisited link colors. Changes to this
property do not dynamically change the link color in Navigator 4 or
earlier. Starting with IE 4 and Netscape 6, you should switch to
using the W3C DOM alternative, <span class="literal">document.body.vLink</span>, or style sheets.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="example"><span class="title">Example</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><span class="programlisting">
<pre>document.vlinkColor = "gold";</pre>
</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="value"><span class="title">Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
A hexadecimal triplet or plain-language color name. See Appendix A for acceptable plain-language color names.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" nowrap colspan="2" class="default"><span class="title">Default</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">#551a8b</span> (Navigator); <span class="literal">#800080</span> (Internet Explorer Windows); <span class="literal">#006010</span> (Internet
Explorer Macintosh).
</p></td>
</tr>
</table>
</div>
<div id="width">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">width</td>
<td valign="top" nowrap class="compatibility"></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
See height.
</p></td>
</tr>
</table>
</div>
<div id="addBinding( ), getAnonymousElementByAttribute( ), getAnonymousNodes( ), getBindingParent( ), loadBindingDocument( ), removeBinding( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">addBinding( ), getAnonymousElementByAttribute( ), getAnonymousNodes( ), getBindingParent( ), loadBindingDocument( ), removeBinding( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
This series of Netscape 6 <span class="literal">document</span> object methods
are part of a browser programming feature called Extensible Binding
Language (XBL), an adjunct to the XML-based mechanism that the
browser uses for generating user interface skins. To learn more about
XBL, visit http://www.mozilla.org/docs/xul/xulnotes/xulnote_xbl.html.
</p></td>
</tr>
</table>
</div>
<div id="captureEvents( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">captureEvents( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">4</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
captureEvents(<span class="replaceable">eventTypeList</span>)
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Instructs the browser to grab events of a specific type before they
reach their intended target objects. The object invoking this method
must then have event handlers defined for the given event types to
process the event. Although this method is part of the Navigator 4
event model, it continues to be supported in Netscape 6, creating the
equivalent of a W3C DOM capture-mode event listener for the document
object. Continue to use this method if you must support Navigator 4,
but migrate new code to the W3C DOM event listener syntax as
described in Chapter 6.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">eventTypeList</var></dt>
<dd>
<p>A comma-separated list of case-sensitive event types as derived from
the available static <span class="LITERAL">Event</span> object constants, such
as <span class="LITERAL">Event.CLICK</span> or
<span class="LITERAL">Event.MOUSEMOVE</span>.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="clear( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">clear( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Removes the current document from the window or frame, usually in
preparation to open a new stream for writing new content. The <span class="literal">document.write( )</span> and <span class="literal">document.writeln(
)</span> methods automatically invoke this method. Many bugs with
the <span class="literal">document.clear( )</span> method plagued earlier
browser versions. Even today, it is best to let the document writing
methods handle the job for you. The W3C DOM explicitly omits this
method.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="close( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">close( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Closes the document writing stream to a window or frame. If a script
uses <span class="literal">document.write( )</span> or <span class="literal">document.writeln( )</span> to generate all-new content
for a window or frame, you must append a <span class="literal">document.close(
)</span> method to make sure the entire content is written to the
document. Omitting this method may cause some content not to be
written. This method also prepares the window or frame for a brand
new set of content with the next document writing method. Do not,
however, use <span class="literal">document.close( )</span> if you use the
document writing methods to dynamically write content to a page while
loading from the server.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="createAttribute( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">createAttribute( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">5(Mac)/6(Win)</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
createAttribute("<span class="replaceable">attributeName</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Generates in memory an instance of an attribute node
(<span class="literal">Attr</span> object). A typical sequence is to create the
attribute, assign a value to it via its <span class="literal">nodeValue</span> property, and then insert the <span class="literal">Attr</span> node into an
element's attribute list via the
element's <span class="literal">setAttributeNode( )</span> method.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">attributeName</var></dt>
<dd>
<p>A case-sensitive string of the attribute's name.</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">Attr</span> node object reference.
</p></td>
</tr>
</table>
</div>
<div id="createAttributeNS( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">createAttributeNS( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">2</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
createAttributeNS("<span class="replaceable">namespaceURI</span>",
"<span class="replaceable">qualifiedName</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Generates in memory an instance of an attribute node
(<span class="literal">Attr</span> object) whose name is defined in an external
namespace. A typical sequence is to create the attribute, assign a
value to it via its <span class="literal">nodeValue</span> property, and then
insert the <span class="literal">Attr</span> node into an
element's attribute list via the
element's <span class="literal">setAttributeNodeNS( )</span> method.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">namespaceURI</var></dt>
<dd>
<p>URI string that will match a URI assigned to a label earlier in the
document into which the attribute is eventually added.
</p>
</dd>
<dt><var class="replaceable">qualifiedName</var></dt>
<dd>
<p>The full name for the attribute, consisting of the local name prefix
(if any), a colon, and the local name.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">Attr</span> node object reference.
</p></td>
</tr>
</table>
</div>
<div id="createCDATASection( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">createCDATASection( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">5(Mac)</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
createCDATASection("<span class="replaceable">data</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Generates in memory an instance of a character data section node
(<span class="literal">CDATASection</span> object) in an XML (including XHTML)
document. Not fully implemented as of Netscape 7.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">data</var></dt>
<dd>
<p>String data that comprises the content of the section.</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">CDATASection</span> node object reference.
</p></td>
</tr>
</table>
</div>
<div id="createComment( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">createComment( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">5(Mac)/6(Win)</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
createComment("<span class="replaceable">commentText</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Generates in memory an instance of a comment node
(<span class="literal">Comment</span> object with a <span class="literal">nodeValue</span> of 8). A typical sequence is to create
the <span class="literal">Comment</span> node, then insert it into the desired
location of the document tree via any node's <span class="literal">appendChild( )</span> or <span class="literal">insertBefore(
)</span> method. Only partially implemented in IE 5/Mac.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">commentText</var></dt>
<dd>
<p>String containing the comment data.</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">Comment</span> node object reference.
</p></td>
</tr>
</table>
</div>
<div id="createDocumentFragment( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">createDocumentFragment( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">5(Mac)/6(Win)</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Generates in memory an instance of an empty document fragment node
(<span class="literal">DocumentFragment</span> object). This node becomes an
arbitrary holder for assembling a sequence of nodes that ultimately
get appended or inserted into a document tree. See the <span class="literal">DocumentFragment</span> object for more details.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">DocumentFragment</span> node object reference.
</p></td>
</tr>
</table>
</div>
<div id="createElement( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">createElement( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
createElement("<span class="replaceable">tagName</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Generates in memory an instance of an element object associated with
the tag passed as a parameter to the method. The method is limited to <span class="literal">area</span>, <span class="literal">img</span>, and <span class="literal">option</span> elements in IE 4; all elements are
permitted in other supporting browsers. A newly created element has
no attribute values assigned (except any default values assigned
according to the DTD), nor is the element yet part of the document
tree. Assign attributes (such as the <span class="literal">type</span> for an <span class="literal">input</span> element or <span class="literal">id</span> for any
element), and append or insert the element into the document tree.
This sequence is the W3C DOM approach to generating new content (in
place of the <span class="literal">innerHTML</span> convenience properties
implemented in IE and Netscape 6 browsers).
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">tagName</var></dt>
<dd>
<p>A string of the tag name of the new element:
<span class="LITERAL">document.createElement(&quot;option&quot;)</span>. IE also allows a
complete start tag string, complete with angle brackets and attribute
name/value pairs. Only the straight tag name is supported by the W3C
DOM specification.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Element object reference.
</p></td>
</tr>
</table>
</div>
<div id="createElementNS( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">createElementNS( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">2</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
createElementNS("<span class="replaceable">namespaceURI</span>",
"<span class="replaceable">qualifiedName</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Generates in memory an instance of an element object associated with
namespace, label, and tag passed as parts of the
method's parameters. A newly created element has no
attribute values assigned (except any default values assigned
according to the DTD), nor is the element yet part of the document
tree. Assign attributes (such as the <span class="literal">type</span> for an <span class="literal">input</span> element or <span class="literal">id</span> for any
element), and append or insert the element into the document tree.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">namespaceURI</var></dt>
<dd>
<p>URI string that will match a URI assigned to a label earlier in the
document into which the attribute is eventually added.
</p>
</dd>
<dt><var class="replaceable">qualifiedName</var></dt>
<dd>
<p>The full name for the attribute, consisting of the local name prefix
(if any), a colon, and the local name.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Element object reference.
</p></td>
</tr>
</table>
</div>
<div id="createEntityReference( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">createEntityReference( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">5(Mac)</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
createEntityReference("<span class="replaceable">entityName</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Generates in memory an instance of an entity reference node object in
an XML document. Only partial support provided in IE 5/Mac and
Netscape as of Version 7.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">entityName</var></dt>
<dd>
<p>String value.</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Entity reference node object reference.
</p></td>
</tr>
</table>
</div>
<div id="createEvent( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">createEvent( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">2</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
createEvent("<span class="replaceable">eventType</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Generates in memory an instance of a W3C DOM <span class="literal">Event</span> object of a particular event category. After the generic event is
created, it must be initialized (via one of several initialization
methods) as a particular event type, along with other properties
appropriate for the event category. The following sequence creates a <span class="literal">mousedown</span> event and sends it to an element:
</p>
<span class="PROGRAMLISTING"><pre>var evt = document.createEvent(&quot;MouseEvents&quot;);
evt.initEvent(&quot;mousedown&quot;, true, true);
document.getElementById(&quot;myElement&quot;).dispatchEvent(evt);</pre></span>
</td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2"><p>
Such an event might then be handed to an element (via the
element's <span class="literal">dispatchEvent( )</span> method) so that the element's event listener can
process the event as if it had been generated by a user clicking the
mouse button.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">eventType</var></dt>
<dd>
<p>String constant for one of the support event categories:
<span class="LITERAL">HTMLEvents</span>, <span class="LITERAL">KeyEvents</span>
(supported by Netscape 6, but not specified until DOM Level 3),
<span class="LITERAL">MouseEvents</span>, <span class="LITERAL">MutationEvents</span>, or
<span class="LITERAL">UIEvents</span>.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">Event</span> object object reference.
</p></td>
</tr>
</table>
</div>
<div id="createEventObject( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">createEventObject( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">5.5(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
createEventObject([<span class="replaceable">existingEventObject</span>])
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Generates in memory an instance of an empty IE DOM <span class="literal">event</span> object. After the generic event is created,
its properties can be stuffed with pertinent values to help the event
be processed. Then the event acts as a parameter to an
element's <span class="literal">fireEvent( )</span> method, at
which point the event type is associated with the event. The
following sequence creates a <span class="literal">mousedown</span> event and
sends it to an element:
</p>
<span class="PROGRAMLISTING"><pre>var evt = document.createEventObject( );
document.getElementById(&quot;myElement&quot;).fireEvent(&quot;onmousedown&quot;, evt);</pre></span>
</td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2"><p>
You can also use an existing event object as a model for a
script-generated event. Pass the current <span class="literal">event</span> object as a parameter to the <span class="literal">createEventObject( )</span> method, and modify the properties of the new object as you see fit.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">existingEventObject</var></dt>
<dd>
<p>Reference to an <span class="LITERAL">event</span> object either generated by
the user or script. The new event assumes all properties of the
existing event object.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">event</span> object reference.
</p></td>
</tr>
</table>
</div>
<div id="createNodeIterator( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">createNodeIterator( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">2</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
createNodeIterator(<span class="replaceable">rootNode</span>, <span class="replaceable">whatToShow</span>, <span class="replaceable">filterFunction</span>, <span class="replaceable">entityRefExpansion</span>)
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Generates in memory an instance of a <span class="literal">NodeIterator</span> object. This method has the same set of parameters as the <span class="literal">createTreeWalker( )</span> method, which is implemented
in Netscape 7.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">rootNode</var></dt>
<dd>
<p>Reference to a node in the document tree that becomes the first node
in the <span class="LITERAL">NodeIterator</span> object's list
of nodes.
</p>
</dd>
<dt><var class="replaceable">whatToShow</var></dt>
<dd>
<p>Integer value corresponding to one of several built-in filters that
allow nodes of a single type to be included in the
<span class="LITERAL">NodeIterator</span> object returned by the method. The
<span class="LITERAL">NodeFilter</span> object contains constants that should
be used as plain-language substitutes for this value:
</p><table border="1">
<tbody>
<tr>
<td><span class="literal">NodeFilter.SHOW_ALL</span></td><td><span class="literal">NodeFilter.SHOW_ATTRIBUTE</span></td></tr>
<tr>
<td><span class="literal">NodeFilter.SHOW_CDATA_SECTION</span></td><td><span class="literal">NodeFilter.SHOW_COMMENT</span></td></tr>
<tr>
<td><span class="literal">NodeFilter.SHOW_DOCUMENT</span></td><td><span class="literal">NodeFilter.SHOW_DOCUMENT_FRAGMENT</span></td></tr>
<tr>
<td><span class="literal">NodeFilter.SHOW_DOCUMENT_TYPE</span></td><td><span class="literal">NodeFilter.SHOW_ELEMENT</span></td></tr>
<tr>
<td><span class="literal">NodeFilter.SHOW_ENTITY</span></td><td><span class="literal">NodeFilter.SHOW_ENTITY_REFERENCE</span></td></tr>
<tr>
<td><span class="literal">NodeFilter.SHOW_NOTATION</span></td><td><span class="literal">NodeFilter.SHOW_PROCESSING_INSTRUCTION</span></td></tr>
<tr>
<td><span class="literal">NodeFilter.SHOW_TEXT</span></td><td></td></tr>
</tbody>
</table>
</dd>
<dt><var class="replaceable">filterFunction</var></dt>
<dd>
<p>Reference to a user function that can further filter nodes that are
included in the <span class="LITERAL">NodeIterator</span> object. The function
has a single parameter (a reference to a node to test, invoked
automatically by the <span class="LITERAL">NodeIterator</span> object). The
value returned by the function determines whether the node being
tested is to be included in the list of nodes. Returned values are
integers, but the <span class="LITERAL">NodeFilter</span> object provides three
constants you should use as plain-language substitutes:
</p><table border="1">
<tbody>
<tr>
<td><span class="literal">NodeFilter.FILTER_ACCEPT</span></td><td><span class="literal">NodeFilter.FILTER_REJECT</span></td></tr>
<tr>
<td><span class="literal">NodeFilter.FILTER_SKIP</span></td><td></td></tr>
</tbody>
</table><p>
Because a <span class="literal">NodeIterator</span> object does not maintain
its list of nodes as a hierarchy, the values <span class="literal">NodeFilter.FILTER_REJECT</span> and <span class="literal">NodeFilter.FILTER_SKIP</span> pass over a node without
any effect on child nodes. See the <span class="literal">TreeWalker</span> object for an example of this kind of function.
</p>
</dd>
<dt><var class="replaceable">entityRefExpansion</var></dt>
<dd>
<p>Boolean value that controls whether the content of entity reference
nodes (found predominantly in XML documents) should be treated as
hierarchical nodes (<span class="LITERAL">true</span>) or not
(<span class="LITERAL">false</span>).
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">NodeIterator</span> object reference.
</p></td>
</tr>
</table>
</div>
<div id="createProcessingInstruction( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">createProcessingInstruction( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">5(Mac)</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
createProcessingInstruction("<span class="replaceable">target</span>",
"<span class="replaceable">data</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Generates in memory an instance of a processing instruction node
object in an XML document. Only partial support provided in IE 5/Mac
and Netscape as of Version 7.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">target</var></dt>
<dd>
<p>String value.</p>
</dd>
<dt><var class="replaceable">data</var></dt>
<dd>
<p>String value.</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Processing instruction node object reference.
</p></td>
</tr>
</table>
</div>
<div id="createRange( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">createRange( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">2</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Creates a blank <span class="literal">Range</span> object, whose boundary
points are collapsed to the point before the first character of the
rendered body text. The method returns a reference to that <span class="literal">Range</span> object, which you then use to adjust its
boundary points, invoke its methods, and so on. See the <span class="literal">Range</span> object for details of its language features.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
W3C DOM <span class="literal">Range</span> object reference.
</p></td>
</tr>
</table>
</div>
<div id="createStyleSheet( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">createStyleSheet( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
createStyleSheet(["<span class="replaceable">url</span>"[, <span class="replaceable">index</span>]])
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
This method performs the same actions in IE for Windows and
Macintosh, but their returned values differ. Moreover, the specific
actions in the document tree depend upon the parameters passed with
the method. When no parameters are included, the method inserts a
blank <span class="literal">style</span> element into the document tree. This <span class="literal">style</span> element, however, is not reflected in the <span class="literal">document.styleSheets</span> collection until you add one
or more style rules to the object. But if you specify a URL to an
external .css file as the first parameter, the method creates and
inserts a <span class="literal">link</span> element into the
document's head section, bringing the external style
rules to life immediately.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2"><p>
IE for Windows always returns a reference to a <span class="literal">styleSheet</span> object; IE for Macintosh returns a
reference to the newly inserted element, which will be a <span class="literal">style</span> or <span class="literal">link</span> element,
depending on the parameter makeup. The inserted <span class="literal">style</span> element reference is of little help for
adding a rule because you can't reference the <span class="literal">styleSheet</span> object. For cross-operating-system
compatibility, it's best to use this method only for
external style sheets.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">url</var></dt>
<dd>
<p>A string of the URL of an external <em>.css</em> style
sheet definition file.
</p>
</dd>
<dt><var class="replaceable">index</var></dt>
<dd>
<p>Optional zero-based integer that indicates where among the
<span class="LITERAL">styleSheets[]</span> collection this new style sheet
should be inserted. Default behavior is to append to the end of the
collection, but this may affect cascading rules for your document.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">styleSheet</span> object reference (Windows); <span class="literal">style</span> or <span class="literal">link</span> element object
reference (IE 5 and later for Macintosh).
</p></td>
</tr>
</table>
</div>
<div id="createTextNode( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">createTextNode( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">5</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
createTextNode("<span class="replaceable">text</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Generates in memory an instance of a text node (W3C DOM <span class="literal">Text</span> object) whose <span class="literal">nodeValue</span> consists of the untagged text content passed as a parameter. A newly
created text node is not yet part of the document tree. Append or
insert the node into the document tree or document fragment being
assembled for later document insertion. This sequence is the W3C DOM
approach to generating new content (in place of the <span class="literal">innerText</span> convenience property implemented in IE
browsers).
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">text</var></dt>
<dd>
<p>A string of characters to be rendered as content when inserted into
the document tree.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Text node object reference.
</p></td>
</tr>
</table>
</div>
<div id="createTreeWalker( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">createTreeWalker( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">7</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">2</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
createTreeWalker(<span class="replaceable">rootNode</span>, <span class="replaceable">whatToShow</span>, <span class="replaceable">filterFunction</span>, <span class="replaceable">entityRefExpansion</span>)
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Generates in memory an instance of a <span class="literal">TreeWalker</span> object.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">rootNode</var></dt>
<dd>
<p>Reference to a node in the document tree that becomes the first node
in the <span class="LITERAL">TreeWalker</span> object's list
of nodes.
</p>
</dd>
<dt><var class="replaceable">whatToShow</var></dt>
<dd>
<p>Integer value corresponding to one of several built-in filters that
allow nodes of a single type to be included in the
<span class="LITERAL">TreeWalker</span> object returned by the method. The
<span class="LITERAL">NodeFilter</span> object contains constants that should
be used as plain-language substitutes for this value:
</p><table border="1">
<tbody>
<tr>
<td><span class="literal">NodeFilter.SHOW_ALL</span></td><td><span class="literal">NodeFilter.SHOW_ATTRIBUTE</span></td></tr>
<tr>
<td><span class="literal">NodeFilter.SHOW_CDATA_SECTION</span></td><td><span class="literal">NodeFilter.SHOW_COMMENT</span></td></tr>
<tr>
<td><span class="literal">NodeFilter.SHOW_DOCUMENT</span></td><td><span class="literal">NodeFilter.SHOW_DOCUMENT_FRAGMENT</span></td></tr>
<tr>
<td><span class="literal">NodeFilter.SHOW_DOCUMENT_TYPE</span></td><td><span class="literal">NodeFilter.SHOW_ELEMENT</span></td></tr>
<tr>
<td><span class="literal">NodeFilter.SHOW_ENTITY</span></td><td><span class="literal">NodeFilter.SHOW_ENTITY_REFERENCE</span></td></tr>
<tr>
<td><span class="literal">NodeFilter.SHOW_NOTATION</span></td><td><span class="literal">NodeFilter.SHOW_PROCESSING_INSTRUCTION</span></td></tr>
<tr>
<td><span class="literal">NodeFilter.SHOW_TEXT</span></td><td></td></tr>
</tbody>
</table>
</dd>
<dt><var class="replaceable">filterFunction</var></dt>
<dd>
<p>Reference to a user function that can further filter nodes that are
included in the <span class="LITERAL">TreeWalker</span> object. The function
has a single parameter (a reference to a node to test, invoked
automatically by the <span class="LITERAL">TreeWalker</span> object). The value
returned by the function determines whether the node being tested is
to be included in the list of nodes. Returned values are integers,
but the <span class="LITERAL">NodeFilter</span> object provides three constants
you should use as plain-language substitutes:
</p><table border="1">
<tbody>
<tr>
<td><span class="literal">NodeFilter.FILTER_ACCEPT</span></td><td><span class="literal">NodeFilter.FILTER_REJECT</span></td></tr>
<tr>
<td><span class="literal">NodeFilter.FILTER_SKIP</span></td><td></td></tr>
</tbody>
</table>
</dd>
</dl>
<dl>
<dd><p>
With a return value of <span class="literal">NodeFilter.FILTER_SKIP</span>,
descendant nodes of the skipped node may still qualify as members of
the <span class="literal">TreeWalker</span> node list (provided they survive
other filtering). A return value of <span class="literal">NodeFilter.FILTER_REJECT</span> removes both the node
under test and its descendants from consideration as members of the <span class="literal">TreeWalker</span> object. See the <span class="literal">TreeWalker</span> object for an example of this kind of
function.
</p>
</dd>
<dt><var class="replaceable">entityRefExpansion</var></dt>
<dd>
<p>Boolean value that controls whether the content of entity reference
nodes (found predominantly in XML documents) should be treated as
hierarchical nodes (<span class="LITERAL">true</span>) or not
(<span class="LITERAL">false</span>).
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">TreeWalker</span> object reference.
</p></td>
</tr>
</table>
</div>
<div id="elementFromPoint( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">elementFromPoint( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
elementFromPoint(<span class="replaceable">x</span>, <span class="replaceable">y</span>)
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a reference to the object directly underneath the pixel
coordinates specified by the <span class="replaceable">x</span> (horizontal) and <span class="replaceable">y</span> (vertical) parameters.
For an element to be recognized, it must be capable of responding to
mouse events. Also, if more than one element is positioned in the
same location, the element with the highest <span class="literal">zIndex</span> value or, given equal <span class="literal">zIndex</span> values, the element
that comes last in the source code order is the one returned.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt>x</dt>
<dd>
<p>Horizontal pixel measure relative to the left edge of the window or
frame.
</p>
</dd>
<dt>y</dt>
<dd>
<p>Vertical pixel measure relative to the top edge of the window or
frame.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Element object reference.
</p></td>
</tr>
</table>
</div>
<div id="execCommand( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">execCommand( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
execCommand("<span class="replaceable">commandName</span>"[, <span class="replaceable">UIFlag</span>[, <span class="replaceable">value</span>]])
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Available only in the Win32 platforms for IE, the <span class="literal">execCommand( )</span> method executes the named command.
Most commands require that a <span class="literal">TextRange</span> object be
created first for an insertion point. See Appendix D for a list of commands.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">commandName</var></dt>
<dd>
<p>A case-insensitive string value of the command name. See <link>Appendix D.
</p>
</dd>
<dt><var class="replaceable">UIFlag</var></dt>
<dd>
<p>Optional Boolean value: <span class="LITERAL">true</span> to display any user
interface triggered by the command (if any); <span class="LITERAL">false</span>
to prevent such display.
</p>
</dd>
<dt><var class="replaceable">value</var></dt>
<dd>
<p>A parameter value for the command. </p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Boolean value: <span class="literal">true</span> if command was successful; <span class="literal">false</span> if unsuccessful.
</p></td>
</tr>
</table>
</div>
<div id="getAnonymousElementByAttribute( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">getAnonymousElementByAttribute( )</td>
<td valign="top" nowrap class="compatibility"></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
See addBinding( ).
</p></td>
</tr>
</table>
</div>
<div id="getAnonymousNodes( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">getAnonymousNodes( )</td>
<td valign="top" nowrap class="compatibility"></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
See addBinding( ).
</p></td>
</tr>
</table>
</div>
<div id="getBindingParent( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">getBindingParent( )</td>
<td valign="top" nowrap class="compatibility"></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
See addBinding( ).
</p></td>
</tr>
</table>
</div>
<div id="getElementById( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">getElementById( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">5</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
getElementById("<span class="replaceable">elementID</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns a reference to an element node from the document tree whose <span class="literal">id</span> attribute value matches the parameter value. If
there is no match, the method returns <span class="literal">null</span>. This
method, although a chore to type while observing its case-sensitive
name, is the gateway for scripts in W3C DOM-capable browsers to
communicate with element objects.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">elementID</var></dt>
<dd>
<p>String of the desired element's ID.</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Reference to element node object.
</p></td>
</tr>
</table>
</div>
<div id="getElementsByName( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">getElementsByName( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">5</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
getElementsByName("<span class="replaceable">elementName</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns an array of references to all element nodes from the document
tree whose <span class="literal">name</span> attribute value matches the
parameter value. If there is no match, the method returns <span class="literal">null</span>. When an element supports both the <span class="literal">name</span> and <span class="literal">id</span> attribute, IE for
Windows includes an element in the returned array even if only the <span class="literal">id</span> attribute is set to the parameter value. IE for
Macintosh and Netscape 6 match only elements that have <span class="literal">name</span> attributes explicitly set to the parameter
value.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">elementName</var></dt>
<dd>
<p>String of the desired element's name.</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Array of references to element node object.
</p></td>
</tr>
</table>
</div>
<div id="getSelection( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">getSelection( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">4</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
In Navigator 4, this method captures the current text selection in
the document. The method is deprecated in Netscape 6 in favor of the <span class="literal">window.getSelection( )</span> method (which returns a
sophisticated <span class="literal">selection</span> object, rather than just
text). Invoking from the <span class="literal">document</span> object displays
a warning in the JavaScript Console window, but does not throw a
full-fledged exception. The IE equivalent is reading the <span class="literal">selection</span> property.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
String.
</p></td>
</tr>
</table>
</div>
<div id="handleEvent[ ]">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">handleEvent[ ]</td>
<td valign="top" nowrap class="compatibility">NN |<span class="emphasis">4|</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
handleEvent(<span class="replaceable">event</span>)
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Instructs the <span class="literal">document</span> object to accept and
process the Navigator 4-only event whose specifications are passed as
the parameter to the method. The object must have an event handler
for the event type to process the event.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">event</var></dt>
<dd>
<p>A Navigator 4 <span class="LITERAL">event</span> object. </p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="hasFocus( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">hasFocus( )</td>
<td valign="top" nowrap class="compatibility">NN n/a IE <span class="emphasis">6</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns Boolean <span class="literal">true</span> if the document or any
element in the document has focus. A background process, such as a
function invoked through <span class="literal">setTimeout( )</span> can find
out if the document's window is currently the front
window on the Desktop.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Boolean value: <span class="literal">true</span> | <span class="literal">false</span>.
</p></td>
</tr>
</table>
</div>
<div id="importNode( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">importNode( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">6</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">2</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
importNode(<span class="replaceable">nodeReference</span>, <span class="replaceable">deepBoolean</span>)
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Imports a node object from another loaded document into the current
document, but not yet into the document tree. In many ways, <span class="literal">importNode( )</span> works like <span class="literal">cloneNode(
)</span>, but it assumes that the source node may exist in an
entirely different document tree context (especially in an XML
document). W3C DOM rules for this method govern what properties and
attributes of the source node make the journey and what happens to
them upon their arrival. For example, an <span class="literal">Attr</span> node
loses its <span class="literal">ownerElement</span> (i.e., its value becomes <span class="literal">null</span>) when imported from an element in one
document into a fragment-like state in the new documentuntil
the attribute gets added to an element in the new document. Nodes of <span class="literal">Document</span> and <span class="literal">DocumentType</span> types
are not importable.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2"><p>
The <span class="literal">importNode( )</span> method does not assume the
responsibility of persistence between documents.
That's where, for instance, a JavaScript variable
comes into play. As with <span class="literal">cloneNode( )</span>, the <span class="literal">importNode( )</span> method does not disturb the source
node.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">nodeReference</var></dt>
<dd>
<p>Reference to a node in a different loaded document (including a
nonrendered document loaded into the browser by way of the
<span class="LITERAL">document.implementation.createDocument( )</span> method).
</p>
</dd>
<dt><var class="replaceable">deepBoolean</var></dt>
<dd>
<p>Boolean value that controls whether the copy includes all nested
nodes (<span class="LITERAL">true</span>) or only the current node
(<span class="LITERAL">false</span>). Required, but applicable primarily to
element nodes.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Reference to the imported copy of the node object.
</p></td>
</tr>
</table>
</div>
<div id="loadBindingDocument( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">loadBindingDocument( )</td>
<td valign="top" nowrap class="compatibility"></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
See addBinding( ).
</p></td>
</tr>
</table>
</div>
<div id="open( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">open( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">1</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
open(["<span class="replaceable">MIMEType</span>"][, "replace"])
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Opens the output stream for writing to the current window or frame.
If <span class="literal">document.clear( )</span> has not already been invoked,
it is automatically invoked in response to the <span class="literal">document.open( )</span> method. Early version bugs may
lead you to use <span class="literal">document.write( )</span> and <span class="literal">document.writeln( )</span> to take care of this method
more reliably for you.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">MIMEType</var></dt>
<dd>
<p>Advises the browser of the MIME type of the data to be written in
subsequent statements. Navigator supports
<span class="LITERAL">&quot;text/html&quot;</span> | <span class="LITERAL">&quot;text/plain&quot;</span> |
<span class="LITERAL">&quot;image/gif&quot;</span> | <span class="LITERAL">&quot;image/jpeg&quot;</span> |
<span class="LITERAL">&quot;image/xbm&quot;</span> | <span class="LITERAL">&quot;plugIn&quot;</span>. Only
<span class="LITERAL">&quot;text/html&quot;</span> is supported in Internet Explorer.
</p>
</dd>
<dt><var class="replaceable">replace</var></dt>
<dd>
<p>The presence of this parameter directs the browser to replace the
entry in the history list for the current document with the document
about to be written.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="queryCommandEnabled( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">queryCommandEnabled( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
queryCommandEnabled("<span class="replaceable">commandName</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Specifies whether the command can be invoked in light of the current
state of the document or selection. Available only in the Win32
platform for IE 4.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2">
<dl>
<dt><var class="replaceable">commandName</var></dt>
<dd>
<p>A case-insensitive string value of the command name.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Boolean value: <span class="literal">true</span> if enabled; <span class="literal">false</span> if not.
</p></td>
</tr>
</table>
</div>
<div id="queryCommandIndeterm( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">queryCommandIndeterm( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
queryCommandIndeterm("<span class="replaceable">commandName</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Specifies whether the command is in an indeterminate state. Available
only in the Win32 platform for IE 4.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2">
<dl>
<dt><var class="replaceable">commandName</var></dt>
<dd>
<p>A case-insensitive string value of the command name.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Boolean value: <span class="literal">true</span> | <span class="literal">false</span>.
</p></td>
</tr>
</table>
</div>
<div id="queryCommandState( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">queryCommandState( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
queryCommandState("<span class="replaceable">commandName</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Determines the current state of the named command. Available only in
the Win32 platform for IE 4.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2">
<dl>
<dt><var class="replaceable">commandName</var></dt>
<dd>
<p>A case-insensitive string value of the command name.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
<span class="literal">true</span> if the command has been completed; <span class="literal">false</span> if the command has not completed; <span class="literal">null</span> if the state cannot be accurately determined.
</p></td>
</tr>
</table>
</div>
<div id="queryCommandSupported( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">queryCommandSupported( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
queryCommandSupported("<span class="replaceable">commandName</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Determines whether the named command is supported by the document
object. Available only in the Win32 platform for IE 4.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2">
<dl>
<dt><var class="replaceable">commandName</var></dt>
<dd>
<p>A case-insensitive string value of the command name.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Boolean value: <span class="literal">true</span> | <span class="literal">false</span>.
</p></td>
</tr>
</table>
</div>
<div id="queryCommandText( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">queryCommandText( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
queryCommandText("<span class="replaceable">commandName</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns text associated with the command. Available only in the Win32
platform for IE 4.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2">
<dl>
<dt><var class="replaceable">commandName</var></dt>
<dd>
<p>A case-insensitive string value of the command name.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
String.
</p></td>
</tr>
</table>
</div>
<div id="queryCommandValue( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">queryCommandValue( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">4(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
queryCommandValue("<span class="replaceable">commandName</span>")
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Returns the value associated with the command, such as the name font
of the selection. Available only in the Win32 platform for IE 4.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2">
<dl>
<dt><var class="replaceable">commandName</var></dt>
<dd>
<p>A case-insensitive string value of the command name.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
Depends on the command.
</p></td>
</tr>
</table>
</div>
<div id="recalc( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">recalc( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">n/a</span> IE <span class="emphasis">5(Win)</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
recalc([<span class="replaceable">allBoolean</span>])
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Forces the recalculation of expressions assigned to element
attributes via the <span class="literal">setExpression( )</span> method. Needed
only when automatic recalculation isn't triggered by
user action, but affected values might have changed.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">allBoolean</var></dt>
<dd>
<p>When set to <span class="LITERAL">true</span>, forces all dynamic attribute
expressions in the document to recalculate. The default
<span class="LITERAL">false</span> lets browser decide which expressions are
affected by changes since the last manual or automatic recalculation.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="releaseEvents( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">releaseEvents( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">4</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
releaseEvents(<span class="replaceable">eventTypeList</span>)
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
The opposite of <span class="literal">document.captureEvents( )</span>, this
method turns off event capture at the document level for one or more
specific events named in the parameter list. In Netscape 6, it
performs the same action as the W3C DOM <span class="literal">removeEventListener(
)</span> method on the <span class="literal">document</span> object. See
Chapter 6.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2">
<dl>
<dt><var class="replaceable">eventTypeList</var></dt>
<dd>
<p>A comma-separated list of case-sensitive event types as derived from
the available <span class="LITERAL">Event</span> object constants, such as
<span class="LITERAL">Event.CLICK</span> or <span class="LITERAL">Event.MOUSEMOVE</span>.
</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="removeBinding( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">removeBinding( )</td>
<td valign="top" nowrap class="compatibility"></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
See addBinding( ).
</p></td>
</tr>
</table>
</div>
<div id="routeEvent( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">routeEvent( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">4</span> IE <span class="emphasis">n/a</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
routeEvent(<span class="replaceable">event</span>)
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
Used inside an event handler function, this method directs Navigator
4 to let the event pass to its intended target object. The method
does not cause an error in Netscape 6, but it does not perform any
action.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">event</var></dt>
<dd>
<p>A Navigator 4 <span class="LITERAL">event</span> object. </p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
<div id="write( ), writeln( )">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="name">write( ), writeln( )</td>
<td valign="top" nowrap class="compatibility">NN <span class="emphasis">2</span> IE <span class="emphasis">3</span> DOM <span class="emphasis">n/a</span></td>
</tr>
<tr>
<td valign="top" nowrap class="usage"><p class="literal">
write("<span class="replaceable">string1</span>"[, ..."<span class="replaceable">stringN</span>"])
writeln("<span class="replaceable">string1</span>"[, ..."<span class="replaceable">stringN</span>"])
</p></td>
<td valign="top" nowrap class="requirements"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description"><p>
When invoked as the page loads, these methods can dynamically add
content to the page. When invoked after the page has loaded, a single
method invocation clears the current document, opens a new output
stream, and writes the content to the window or frame. A <span class="literal">document.close( )</span> method is required afterward.
Because the first <span class="literal">document.write( )</span> or <span class="literal">document.writeln( )</span> method destroys the current
document, do not use two or more writing statements to create a new
document. Instead, load the content into one variable and pass that
variable as the parameter to a single <span class="literal">document.write(
)</span> or <span class="literal">document.writeln( )</span> method.
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2"><p>
Using <span class="literal">document.write( )</span> for <span class="literal">&lt;script&gt;</span> tags is tricky in Navigator because
it typically interprets the writing of the end script tag as meaning
the end of the script doing the writing. You should have success,
however, if you split the end script tag into string sections:
</p>
<span class="PROGRAMLISTING"><pre>document.write(&lt;&quot; + &quot;/script&gt;&quot;);&quot;</pre></span>
</td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2"><p>
If you include the "hide script"
comment trick, write it this way:
</p>
<span class="PROGRAMLISTING"><pre>document.write(&quot;//--&quot; + &gt;&quot;);&quot;</pre></span>
</td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2"><p>
The difference between the two methods is that <span class="literal">document.writeln( )</span> adds a carriage return to the
source code it writes to the document. This is not reflected in the
rendered content, but can make reading the dynamic source code easier
in browser versions that support dynamic content source viewing
(Navigator 4 does so as a <span class="literal">wysiwyg:</span> URL in the
source view window).
</p></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="parameters"><span class="title">Parameters</span></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td><dl>
<dt><var class="replaceable">string</var></dt>
<dd>
<p>Any string value, including HTML tags.</p>
</dd>
</dl></td>
</tr>
<tr>
<td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td valign="top" colspan="2" class="returnedvalue"><span class="title">Returned Value</span></td>
</tr>
<tr>
<td colspan="2"><p>
None.
</p></td>
</tr>
</table>
</div>
</body>
</html>
