DOM operations only raise exceptions in "exceptional" circumstances, i.e., when an operation is impossible to perform (either for logical reasons, because data is lost, or because the implementation has become unstable). In general, DOM methods return specific error values in ordinary processing situation, such as out-of-bound errors when usingNodeList.

Implementations may raise other exceptions under other circumstances. For example, implementations may raise an implementation-dependent exception if anullargument is passed.

Some languages and object systems do not support the concept of exceptions. For such systems, error conditions may be indicated using native error reporting mechanisms. For some bindings, for example, methods may return error codes similar to those listed in the corresponding method descriptions.

 unsigned short

An integer indicating the type of error generated.

If index or size is negative, or greater than the allowed value

If the specified range of text does not fit into a DOMString

If any node is inserted somewhere it doesn't belong

If a node is used in a different document than the one that created it (that doesn't support it)

If an invalid character is specified, such as in a name.

If data is specified for a node which does not support data

If an attempt is made to modify an object where modifications are not allowed

If an attempt was made to reference a node in a context where it does not exist

If the implementation does not support the type of object requested

If an attempt is made to add an attribute that is already inuse elsewhere

TheDOMImplementationinterface provides a number of methods for performing operations that are independent of any particular instance of the document object model.

The DOM Level 1 does not specify a way of creating a document instance, and hence document creation is an operation specific to an implementation. Future Levels of the DOM specification are expected to provide methods for creating documents directly.

Test if the DOM implementation implements a specific feature.

The package name of the feature to test. In Level 1, the legal values are "HTML" and "XML" (case-insensitive).

This is the version number of the package name to test. In Level 1, this is the string "1.0". If the version is not specified, supporting any version of the feature will cause the method to returntrue.

trueif the feature is implemented in the specified version,falseotherwise.

DocumentFragmentis a "lightweight" or "minimal"Documentobject. It is very common to want to be able to extract a portion of a document's tree or to create a new fragment of a document. Imagine implementing a user command like cut or rearranging a document by moving fragments around. It is desirable to have an object which can hold such fragments and it is quite natural to use a Node for this purpose. While it is true that aDocumentobject could fulfil this role, aDocumentobject can potentially be a heavyweight object, depending on the underlying implementation. What is really needed for this is a very lightweight object.DocumentFragmentis such an object.

Furthermore, various operations -- such as inserting nodes as children of anotherNode-- may takeDocumentFragmentobjects as arguments; this results in all the child nodes of theDocumentFragmentbeing moved to the child list of this node.

The children of aDocumentFragmentnode are zero or more nodes representing the tops of any sub-trees defining the structure of the document.DocumentFragmentnodes do not need to be well-formed XML documents (although they do need to follow the rules imposed upon well-formed XML parsed entities, which can have multiple top nodes). For example, aDocumentFragmentmight have only one child and that child node could be aTextnode. Such a structure model represents neither an HTML document nor a well-formed XML document.

When aDocumentFragmentis inserted into aDocument(or indeed any otherNodethat may take children) the children of theDocumentFragmentand not theDocumentFragmentitself are inserted into theNode. This makes theDocumentFragmentvery useful when the user wishes to create nodes that are siblings; theDocumentFragmentacts as the parent of these nodes so that the user can use the standard methods from theNodeinterface, such asinsertBefore()andappendChild().

TheDocumentinterface represents the entire HTML or XML document. Conceptually, it is the root of the document tree, and provides the primary access to the document's data.

Since elements, text nodes, comments, processing instructions, etc. cannot exist outside the context of aDocument, theDocumentinterface also contains the factory methods needed to create these objects. TheNodeobjects created have aownerDocumentattribute which associates them with theDocumentwithin whose context they were created.

The Document Type Declaration (seeDocumentType) associated with this document. For HTML documents as well as XML documents without a document type declaration this returnsnull. The DOM Level 1 does not support editing the Document Type Declaration, thereforedocTypecannot be altered in any way.

TheDOMImplementationobject that handles this document. A DOM application may use objects from multiple implementations.

This is a convenience attribute that allows direct access to the child node that is the root element of the document. For HTML documents, this is the element with the tagName "HTML".

Creates an element of the type specified. Note that the instance returned implements theElementinterface, so attributes can be specified directly on the returned object.

The name of the element type to instantiate. For XML, this is case-sensitive. For HTML, thetagNameparameter may be provided in any case, but it must be mapped to the canonical uppercase form by the DOM implementation.

A newElementobject.

INVALID_CHARACTER_ERR: Raised if the specified name contains an invalid character.

Returns the Element whoseidis given by elementId. If no such element exists, returnsnull. Behavior is not defined if more than one element has thisid.

The uniqueidvalue for an element.

The matching element.

Creates an emptyDocumentFragmentobject.

A newDocumentFragment.

Creates aTextnode given the specified string.

The data for the node.

The newTextobject.

Creates aCommentnode given the specified string.

The data for the node.

The newCommentobject.

Creates aCDATASectionnode whose value is the specified string.

The data for theCDATASectioncontents.

The newCDATASectionobject.

NOT_SUPPORTED_ERR: Raised if this document is an HTML document.

Creates aProcessingInstructionnode given the specified name and data strings.

The target part of the processing instruction.

The data for the node.

The newProcessingInstructionobject.

INVALID_CHARACTER_ERR: Raised if an invalid character is specified.

NOT_SUPPORTED_ERR: Raised if this document is an HTML document.

Creates anAttrof the given name. Note that theAttrinstance can then be set on anElementusing thesetAttributemethod.

The name of the attribute.

A newAttrobject.

INVALID_CHARACTER_ERR: Raised if the specified name contains an invalid character.

Creates an EntityReference object.

The name of the entity to reference.

The newEntityReferenceobject.

INVALID_CHARACTER_ERR: Raised if the specified name contains an invalid character.

NOT_SUPPORTED_ERR: Raised if this document is an HTML document.

Returns aNodeListof all theElements with a given tag name in the order in which they would be encountered in a preorder traversal of theDocumenttree.

The name of the tag to match on. The special value "*" matches all tags.

A newNodeListobject containing all the matchedElements.

TheNodeinterface is the primary datatype for the entire Document Object Model. It represents a single node in the document tree. While all objects implementing theNodeinterface expose methods for dealing with children, not all objects implementing theNodeinterface may have children. For example,Textnodes may not have children, and adding children to such nodes results in aDOMExceptionbeing raised.

The attributesnodeName,nodeValueandattributesare included as a mechanism to getat node information without casting down to the specific derived interface. In cases where there is no obvious mapping of these attributes for a specificnodeType(e.g.,nodeValuefor an Element orattributesfor a Comment), this returnsnull. Note that the specialized interfaces may contain additional and more convenient mechanisms to get and set the relevant information.

An integer indicating which type of node this is.

The node is aElement.

The node is anAttr.

The node is aTextnode.

The node is aCDATASection.

The node is anEntityReference.

The node is anEntity.

The node is aProcessingInstruction.

The node is aComment.

The node is aDocument.

The node is aDocumentType.

The node is aDocumentFragment.

The node is aNotation.

The values ofnodeName,nodeValue, andattributesvary according to the node type as follows:
nodeName nodeValue attributes
Element tagName null NamedNodeMap
Attr name of attribute value of attribute null
Text #text content of the text node null
CDATASection #cdata-section content of the CDATA Section null
EntityReference name of entity referenced null null
Entity entity name null null
ProcessingInstruction target entire content excluding the target null
Comment #comment content of the comment null
Document #document null null
DocumentType document type name null null
DocumentFragment #document-fragment null null
Notation notation name null null

The name of this node, depending on its type; see the table above.

The value of this node, depending on its type; see the table above.

NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.

DOMSTRING_SIZE_ERR: Raised when it would return more characters than fit in aDOMStringvariable on the implementation platform.

A code representing the type of the underlying object, as defined above.

The parent of this node. All nodes, exceptDocument,DocumentFragment, andAttrmay have a parent. However, if a node has just been created and not yet added to the tree, or if it has been removed from the tree, this isnull.

ANodeListthat contains all children of this node. If there are no children, this is aNodeListcontaining no nodes. The content of the returnedNodeListis "live" in the sense that, for instance, changes to the children of the node object that it was created from are immediately reflected in the nodes returned by theNodeListaccessors; it is not a static snapshot of the content of the node. This is true for everyNodeList, including the ones returned by thegetElementsByTagNamemethod.

The first child of this node. If there is no such node, this returnsnull.

The last child of this node. If there is no such node, this returnsnull.

The node immediately preceding this node. If there is no such node, this returnsnull.

The node immediately following this node. If there is no such node, this returnsnull.

ANamedNodeMapcontaining the attributes of this node (if it is anElement) ornullotherwise.

TheDocumentobject associated with this node. This is also theDocumentobject used to create new nodes. When this node is aDocumentthis isnull.

Inserts the nodenewChildbefore the existing child noderefChild. IfrefChildisnull, insertnewChildat the end of the list of children.

IfnewChildis aDocumentFragmentobject, all of its children are inserted, in the same order, beforerefChild. If thenewChildis already in the tree, it is first removed.

The node to insert.

The reference node, i.e., the node before which the new node must be inserted.

The node being inserted.

HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not allow children of the type of thenewChildnode, or if the node to insert is one of this node's ancestors.

WRONG_DOCUMENT_ERR: Raised ifnewChildwas created from a different document than the one that created this node.

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

NOT_FOUND_ERR: Raised ifrefChildis not a child of this node.

Replaces the child nodeoldChildwithnewChildin the list of children, and returns theoldChildnode. If thenewChildis already in the tree, it is first removed.

The new node to put in the child list.

The node being replaced in the list.

The node replaced.

HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not allow children of the type of thenewChildnode, or it the node to put in is one of this node's ancestors.

WRONG_DOCUMENT_ERR: Raised ifnewChildwas created from a different document than the one that created this node.

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

NOT_FOUND_ERR: Raised ifoldChildis not a child of this node.

Removes the child node indicated byoldChildfrom the list of children, and returns it.

The node being removed.

The node removed.

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

NOT_FOUND_ERR: Raised ifoldChildis not a child of this node.

Adds the nodenewChildto the end of the list of children of this node. If thenewChildis already in the tree, it is first removed.

The node to add.

If it is aDocumentFragmentobject, the entire contents of the document fragment are moved into the child list of this node

The node added.

HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not allow children of the type of thenewChildnode, or if the node to append is one of this node's ancestors.

WRONG_DOCUMENT_ERR: Raised ifnewChildwas created from a different document than the one that created this node.

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

This is a convenience method to allow easy determination of whether a node has any children.

trueif the node has any children,falseif the node has no children.

Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNodereturnsnull.).

Cloning anElementcopies all attributes and their values, including those generated by the XML processor to represent defaulted attributes, but this method does not copy any text it contains unless it is a deep clone, since the text is contained in a childTextnode. Cloning any other type of node simply returns a copy of this node.

Iftrue, recursively clone the subtree under the specified node; iffalse, clone only the node itself (and its attributes, if it is anElement).

The duplicate node.

TheNodeListinterface provides the abstraction of an ordered collection of nodes, without defining or constraining how this collection is implemented.

The items in theNodeListare accessible via an integral index, starting from 0.

Returns theindexth item in the collection. Ifindexis greater than or equal to the number of nodes in the list, this returnsnull.

Index into the collection.

The node attheindexth position in theNodeList, ornullif that is not a valid index.

The number of nodes in the list. The range of valid child node indices is 0 tolength-1inclusive.

Objects implementing theNamedNodeMapinterface are used to represent collections of nodes that can be accessed by name. Note thatNamedNodeMapdoes not inherit fromNodeList;NamedNodeMaps are not maintained in any particular order. Objects contained in an object implementingNamedNodeMapmay also be accessed by an ordinal index, but this is simply to allow convenient enumeration of the contents of aNamedNodeMap, and does not imply that the DOM specifies an order to these Nodes.

Retrieves a node specified by name.

Name of a node to retrieve.

ANode(of any type) with the specified name, ornullif the specified name did not identify any node in the map.

Adds a node using itsnodeNameattribute.

As thenodeNameattribute is used to derive the name which the node must be stored under, multiple nodes of certain types (those that have a "special" string value) cannot be stored as the names would clash. This is seen as preferable to allowing nodes to be aliased.

A node to store in a named node map. The node will later be accessible using the value of thenodeNameattribute of the node. If a node with that name is already present in the map, it is replaced by the new one.

If the newNodereplaces an existing node with the same name the previously existingNodeis returned, otherwisenullis returned.

WRONG_DOCUMENT_ERR: Raised ifargwas created from a different document than the one that created theNamedNodeMap.

NO_MODIFICATION_ALLOWED_ERR: Raised if thisNamedNodeMapis readonly.

INUSE_ATTRIBUTE_ERR: Raised ifargis anAttrthat is already an attribute of anotherElementobject. The DOM user must explicitly cloneAttrnodes to re-use them in other elements.

Removes a node specified by name. If the removed node is anAttrwith a default value it is immediately replaced.

The name of a node to remove.

The node removed from the map ornullif no node with such a name exists.

NOT_FOUND_ERR: Raised if there is no node named name in this map.

NO_MODIFICATION_ALLOWED_ERR: Raised if this map is readonly.

Returns theindexth item in the map. Ifindexis greater than or equal to the number of nodes in the map, this returnsnull.

Index into the map.

The node at theindexth position in theNamedNodeMap, ornullif that is not a valid index.

The number of nodes in the map. The range of valid child node indices is 0 tolength-1inclusive.

TheCharacterDatainterface extends Node with a set of attributes and methods for accessing character data in the DOM. For clarity this set is defined here rather than on each object that uses these attributes and methods. No DOM objects correspond directly toCharacterData, thoughTextand others do inherit the interface from it. Alloffsets in this interface start from 0.

The character data of the node that implements this interface. The DOM implementation may not put arbitrary limits on the amount of data that may be stored in aCharacterDatanode. However, implementation limits may mean that the entirety of a node's data may not fit into a singleDOMString. In such cases, the user may callsubstringDatato retrieve the data in appropriately sized pieces.

NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.

DOMSTRING_SIZE_ERR: Raised when it would return more characters than fit in aDOMStringvariable on the implementation platform.

The number of characters that are available throughdataand thesubstringDatamethod below. This may have the value zero, i.e.,CharacterDatanodes may be empty.

Extracts a range of data from the node.

Start offset of substring to extract.

The number of characters to extract.

The specified substring. If the sum ofoffsetandcountexceeds thelength, then all characters to the end of the data are returned.

INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of characters indata, or if the specifiedcountis negative.

DOMSTRING_SIZE_ERR: Raised if the specified range of text does not fit into aDOMString.

Append the string to the end of the character data of the node. Upon success,dataprovides access to the concatenation ofdataand theDOMStringspecified.

TheDOMStringto append.

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

Insert a string at the specified character offset.

The character offset at which to insert.

TheDOMStringto insert.

INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of characters indata.

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

Remove a range of characters from the node. Upon success,dataandlengthreflect the change.

The offset from which to remove characters.

The number of characters to delete. If the sum ofoffsetandcountexceedslengththen all characters fromoffsetto the end of the data are deleted.

INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of characters indata, or if the specifiedcountis negative.

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

Replace the characters starting at the specified character offset with the specified string.

The offset from which to start replacing.

The number of characters to replace. If the sum ofoffsetandcountexceedslength, then all characters to the end of the data are replaced (i.e., the effect is the same as aremovemethod call with the same range, followed by anappendmethod invocation).

TheDOMStringwith which the range must be replaced.

INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of characters indata, or if the specifiedcountis negative.

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

TheAttrinterface represents an attribute in anElementobject. Typically the allowable values for the attribute are defined in a document type definition.

Attrobjects inherit theNodeinterface, but since they are not actually child nodes of the element they describe, the DOM does not consider them part of the document tree. Thus, theNodeattributesparentNode,previousSibling, andnextSiblinghave a null value forAttrobjects. The DOM takes the view that attributes are properties of elements rather than having a separate identity from the elements they are associated with; this should make it more efficient to implement such features as default attributes associated with all elements of a given type. Furthermore,Attrnodes may not be immediate children of aDocumentFragment. However, they can be associated withElementnodes contained within aDocumentFragment. In short, users and implementors of the DOM need to be aware thatAttrnodes have some things in common with other objects inheriting theNodeinterface, but they also are quite distinct.

The attribute's effective value is determined as follows: if this attribute has been explicitly assigned any value, that value is the attribute's effective value; otherwise, if there is a declaration for this attribute, and that declaration includes a default value, then that default value is the attribute's effective value; otherwise, the attribute does not exist on this element in the structure model until it has been explicitly added. Note that thenodeValueattribute on theAttrinstance can also be used to retrieve the string version of the attribute's value(s).

In XML, where the value of an attribute can contain entity references, the child nodes of theAttrnode provide a representation in which entity references are not expanded. These child nodes may be eitherTextorEntityReferencenodes. Because the attribute type may be unknown, there are no tokenized attribute values.

Returns the name of this attribute.

If this attribute was explicitly given a value in the original document, this istrue; otherwise, it isfalse. Note that the implementation is in charge of this attribute, not the user. If the user changes the value of the attribute (even if it ends up having the same value as the default value) then thespecifiedflag is automatically flipped totrue. To re-specify the attribute as the default value from the DTD, the user must delete the attribute. The implementation will then make a new attribute available withspecifiedset tofalseand the default value (if one exists).

In summary:

If the attribute has an assigned value in the document thenspecifiedistrue, and the value is the assigned value.

If the attribute has no assigned value in the document and has a default value in the DTD, thenspecifiedisfalse, and the value is the default value in the DTD.

If the attribute has no assigned value in the document and has a value of #IMPLIED in the DTD, then the attribute does not appear in the structure model of the document.

On retrieval, the value of the attribute is returned as a string. Character and general entity references are replaced with their values.

On setting, this creates aTextnode with the unparsed contents of the string.

NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.

By far the vast majority of objects (apart from text) that authors encounter when traversing a document areElementnodes. Assume the following XML document:<elementExample id="demo"> <subelement1/> <subelement2><subsubelement/></subelement2> </elementExample>

When represented using DOM, the top node is anElementnode for "elementExample", which contains two childElementnodes, one for "subelement1" and one for "subelement2". "subelement1" contains no child nodes.

Elements may have attributes associated with them; since theElementinterface inherits fromNode, the genericNodeinterface methodgetAttributesmay be used to retrieve the set of all attributes for an element. There are methods on theElementinterface to retrieve either anAttrobject by name or an attribute value by name. In XML, where an attribute value may contain entity references, anAttrobject should be retrieved to examine the possibly fairly complex sub-tree representing the attribute value. On the other hand, in HTML, where all attributes have simple string values, methods to directly access an attribute value can safely be used as a convenience.

The name of the element. For example, in:<elementExample id="demo"> ... </elementExample> , tagNamehas the value"elementExample". Note that this is case-preserving in XML, as are all of the operations of the DOM. The HTML DOM returns thetagNameof an HTML element in the canonical uppercase form, regardless of the case in the source HTML document.

Retrieves an attribute value by name.

The name of the attribute to retrieve.

TheAttrvalue as a string, or the empty string if that attribute does not have a specified or default value.

Adds a new attribute. If an attribute with that name is already present in the element, its value is changed to be that of the value parameter. This value is a simple string, it is not parsed as it is being set. So any markup (such as syntax to be recognized as an entity reference) is treated as literal text, and needs to be appropriately escaped by the implementation when it is written out. In order to assign an attribute value that contains entity references, the user must create anAttrnode plus anyTextandEntityReferencenodes, build the appropriate subtree, and usesetAttributeNodeto assign it as the value of an attribute.

The name of the attribute to create or alter.

Value to set in string form.

INVALID_CHARACTER_ERR: Raised if the specified name contains an invalid character.

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

Removes an attribute by name. If the removed attribute has a default value it is immediately replaced.

The name of the attribute to remove.

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

Retrieves anAttrnode by name.

The name of the attribute to retrieve.

TheAttrnode with the specified attribute name ornullif there is no such attribute.

Adds a new attribute. If an attribute with that name is already present in the element, it is replaced by the new one.

TheAttrnode to add to the attribute list.

If thenewAttrattribute replaces an existing attribute with the same name, the previously existingAttrnode is returned, otherwisenullis returned.

WRONG_DOCUMENT_ERR: Raised ifnewAttrwas created from a different document than the one that created the element.

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

INUSE_ATTRIBUTE_ERR: Raised ifnewAttris already an attribute of anotherElementobject. The DOM user must explicitly cloneAttrnodes to re-use them in other elements.

Removes the specified attribute.

TheAttrnode to remove from the attribute list. If the removedAttrhas a default value it is immediately replaced.

TheAttrnode that was removed.

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

NOT_FOUND_ERR: Raised ifoldAttris not an attribute of the element.

Returns aNodeListof all descendant elements with a given tag name, in the order in which they would be encountered in a preorder traversal of theElementtree.

The name of the tag to match on. The special value "*" matches all tags.

A list of matchingElementnodes.

Puts allTextnodes in the full depth of the sub-tree underneath thisElementinto a "normal" form where only markup (e.g., tags, comments, processing instructions, CDATA sections, and entity references) separatesTextnodes, i.e., there are no adjacentTextnodes. This can be used to ensure that the DOM view of a document is the same as if it were saved and re-loaded, and is useful when operations (such as XPointer lookups) that depend on a particular document tree structure are to be used.

TheTextinterface represents the textual content (termedcharacterdatain XML) of anElementorAttr. If there is no markup inside an element's content, the text is contained in a single object implementing theTextinterface that is the only child of the element. If there is markup, it is parsed into a list of elements andTextnodes that form the list of children of the element.

When a document is first made available via the DOM, there is only oneTextnode for each block of text. Users may create adjacentTextnodes that represent the contents of a given element without any intervening markup, but should be aware that there is no way to represent the separations between these nodes in XML or HTML, so they will not (in general) persist between DOM editing sessions. Thenormalize()method onElementmerges any such adjacentTextobjects into a single node for each block of text; this is recommended before employing operations that depend on a particular document structure, such as navigation withXPointers.

Breaks thisTextnode into two Text nodes at the specified offset, keeping both in the tree as siblings. This node then only contains all the content up to theoffsetpoint. And a newTextnode, which is inserted as the next sibling of this node, contains all the content at and after theoffsetpoint.

The offset at which to split, starting from 0.

The newTextnode.

INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of characters indata.

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

This represents the content of a comment, i.e., all the characters between the starting '<!--' and ending '-->'. Note that this is the definition of a comment in XML, and, in practice, HTML, although some HTML tools may implement the full SGML comment structure.

CDATA sections are used to escape blocks of text containing characters that would otherwise be regarded as markup. The only delimiter that is recognized in a CDATA section is the "]]>" string that ends the CDATA section. CDATA sections can not be nested. The primary purpose is for including material such as XML fragments, without needing to escape all the delimiters.

TheDOMStringattribute of theTextnode holds the text that is contained by the CDATA section. Note that thismaycontain characters that need to be escaped outside of CDATA sections and that, depending on the character encoding ("charset") chosen for serialization, it may be impossible to write out some characters as part of a CDATA section.

TheCDATASectioninterface inherits theCharacterDatainterface through theTextinterface. AdjacentCDATASectionsnodes are not merged by use of the Element.normalize() method.

EachDocumenthas adoctypeattribute whose value is eithernullor aDocumentTypeobject. TheDocumentTypeinterface in the DOM Level 1 Core provides an interface to the list of entities that are defined for the document, and little else because the effect of namespaces and the various XML scheme efforts on DTD representation are not clearly understood as of this writing.

The DOM Level 1 doesn't support editingDocumentTypenodes.

The name of DTD; i.e., the name immediately following theDOCTYPEkeyword.

ANamedNodeMapcontaining the general entities, both external and internal, declared in the DTD. Duplicates are discarded. For example in:<!DOCTYPE ex SYSTEM "ex.dtd" [ <!ENTITY foo "foo"> <!ENTITY bar "bar"> <!ENTITY % baz "baz"> ]> <ex/>the interface provides access tofooandbarbut notbaz. Every node in this map also implements theEntityinterface.

The DOM Level 1 does not support editing entities, thereforeentitiescannot be altered in any way.

ANamedNodeMapcontaining the notations declared in the DTD. Duplicates are discarded. Every node in this map also implements theNotationinterface.

The DOM Level 1 does not support editing notations, thereforenotationscannot be altered in any way.

This interface represents a notation declared in the DTD. A notation either declares, by name, the format of an unparsed entity (see section 4.7 of the XML 1.0 specification), or is used for formal declaration of Processing Instruction targets (see section 2.6 of the XML 1.0 specification). ThenodeNameattribute inherited fromNodeis set to the declared name of the notation.

The DOM Level 1 does not support editingNotationnodes; they are therefore readonly.

ANotationnode does not have any parent.

The public identifier of this notation. If the public identifier was not specified, this isnull.

The system identifier of this notation. If the system identifier was not specified, this isnull.

This interface represents an entity, either parsed or unparsed, in an XML document. Note that this models the entity itselfnotthe entity declaration.Entitydeclaration modeling has been left for a later Level of the DOM specification.

ThenodeNameattribute that is inherited fromNodecontains the name of the entity.

An XML processor may choose to completely expand entities before the structure model is passed to the DOM; in this case there will be noEntityReferencenodes in the document tree.

XML does not mandate that a non-validating XML processor read and process entity declarations made in the external subset or declared in external parameter entities. This means that parsed entities declared in the external subset need not be expanded by some classes of applications, and that the replacement value of the entity may not be available. When the replacement value is available, the correspondingEntitynode's child list represents the structure of that replacement text. Otherwise, the child list is empty.

The resolution of the children of theEntity(the replacement value) may be lazily evaluated; actions by the user (such as calling thechildNodesmethod on theEntityNode) are assumed to trigger the evaluation.

The DOM Level 1 does not support editingEntitynodes; if a user wants to make changes to the contents of anEntity, every relatedEntityReferencenode has to be replaced in the structure model by a clone of theEntity's contents, and then the desired changes must be made to each of those clones instead. All the descendants of anEntitynode are readonly.

AnEntitynode does not have any parent.

The public identifier associated with the entity, if specified. If the public identifier was not specified, this isnull.

The system identifier associated with the entity, if specified. If the system identifier was not specified, this isnull.

For unparsed entities, the name of the notation for the entity. For parsed entities, this isnull.

EntityReferenceobjects may be inserted into the structure model when an entity reference is in the source document, or when the user wishes to insert an entity reference. Note that character references and references to predefined entities are considered to be expanded by the HTML or XML processor so that characters are represented by their Unicode equivalent rather than by an entity reference. Moreover, the XMLprocessor may completely expand references to entities while building the structure model, instead of providingEntityReferenceobjects. If it does provide such objects, then for a givenEntityReferencenode, it may be that there is noEntitynode representing the referenced entity; but if such anEntityexists, then the child list of theEntityReferencenode is the same as that of theEntitynode. As with theEntitynode, all descendants of theEntityReferenceare readonly.

The resolution of the children of theEntityReference(the replacement value of the referencedEntity) may be lazily evaluated; actions by the user (such as calling thechildNodesmethod on theEntityReferencenode) are assumed to trigger the evaluation.

TheProcessingInstructioninterface represents a "processing instruction", used in XML as a way to keep processor-specific information in the text of the document.

The target of this processing instruction. XML defines this as being the first token following the markup that begins the processing instruction.

The content of this processing instruction. This is from the first non white space character after the target to the character immediately preceding the?>.

NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.

AnHTMLCollectionis a list of nodes. An individual node may be accessed by either ordinal index or the node'snameoridattributes.Note:Collections in the HTML DOM are assumed to belivemeaning that they are automatically updated when the underlying document is changed.

This attribute specifies the length orsizeof the list.

This method retrieves a node specified by ordinal index. Nodes are numbered in tree order (depth-first traversal order).

The index of the node to be fetched. The index origin is 0.

TheNodeat the corresponding position upon success. A value ofnullis returned if the index is out of range.

This method retrieves aNodeusing a name. It first searches for aNodewith a matchingidattribute. If it doesn't find one, it then searches for aNodewith a matchingnameattribute, but only on those elements that are allowed a name attribute.

The name of theNodeto be fetched.

TheNodewith anameoridattribute whose value corresponds to the specified string. Upon failure (e.g., no node with this name exists), returnsnull.

AnHTMLDocumentis the root of the HTML hierarchy and holds the entire content. Beside providing access to the hierarchy, it also provides some convenience methods for accessing certain sets of information from the document.

The following properties have been deprecated in favor of the corresponding ones for the BODY element:

alinkColor

background

bgColor

fgColor

linkColor

vlinkColor

The title of a document as specified by theTITLEelement in the head of the document.

Returns the URI of the page that linked to this page. The value is an empty string if the user navigated to the page directly (not through a link, but, for example, via a bookmark).

The domain name of the server that served the document, or a null string if the server cannot be identified by a domain name.

The complete URI of the document.

The element that contains the content for the document. In documents withBODYcontents, returns theBODYelement, and in frameset documents, this returns the outermostFRAMESETelement.

A collection of all theIMGelements in a document. The behavior is limited toIMGelements for backwards compatibility.

A collection of all theOBJECTelements that include applets andAPPLET(deprecated) elements in a document.

A collection of allAREAelements and anchor (A) elements in a document with a value for thehrefattribute.

A collection of all the forms of a document.

A collection of all the anchor (A) elements in a document with a value for thenameattribute.Note.For reasons of backwards compatibility, the returned set of anchors only contains those anchors created with thenameattribute, not those created with theidattribute.

The cookies associated with this document. If there are none, the value is an empty string. Otherwise, the value is a string: a semicolon-delimited list of "name, value" pairs for all the cookies associated with the page. For example,name=value;expires=date.

Note.This method and the ones following allow a user to add to or replace the structure model of a document using strings of unparsed HTML. At the time of writing alternate methods for providing similar functionality for both HTML and XML documents were being considered. The following methods may be deprecated at some point in the future in favor of a more general-purpose mechanism.

Open a document stream for writing. If a document exists in the target, this method clears it.

Closes a document stream opened byopen()and forces rendering.

Write a string of text to a document stream opened byopen(). The text is parsed into the document's structure model.

The string to be parsed into some structure in the document structure model.

Write a string of text followed by a newline character to a document stream opened byopen(). The text is parsed into the document's structure model.

The string to be parsed into some structure in the document structure model.

Returns the (possibly empty) collection of elements whosenamevalue is given byelementName.

Thenameattribute value for an element.

The matching elements.

All HTML element interfaces derive from this class. Elements that only expose the HTML core attributes are represented by the baseHTMLElementinterface. These elements are as follows:

HEAD

special: SUB, SUP, SPAN, BDO

font: TT, I, B, U, S, STRIKE, BIG, SMALL

phrase: EM, STRONG, DFN, CODE, SAMP, KBD, VAR, CITE, ACRONYM, ABBR

list: DD, DT

NOFRAMES, NOSCRIPT

ADDRESS, CENTER

Note.Thestyleattribute for this interface is reserved for future usage.

The element's identifier. See theid attribute definitionin HTML 4.0.

The element's advisory title. See thetitle attribute definitionin HTML 4.0.

Language code defined in RFC 1766. See thelang attribute definitionin HTML 4.0.

Specifies the base direction of directionally neutral text and the directionality of tables. See thedir attribute definitionin HTML 4.0.

The class attribute of the element. This attribute has been renamed due to conflicts with the "class" keyword exposed by many languages. See theclass attribute definitionin HTML 4.0.

Root of an HTML document. See theHTML element definitionin HTML 4.0.

Version information about the document's DTD. See theversion attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Document head information. See theHEAD element definitionin HTML 4.0.

URI designating a metadata profile. See theprofile attribute definitionin HTML 4.0.

TheLINKelement specifies a link to an external resource, and defines this document's relationship to that resource (or vice versa). See theLINK element definitionin HTML 4.0.

Enables/disables the link. This is currently only used for style sheet links, and may be used to activate or deactivate style sheets.

The character encoding of the resource being linked to. See thecharset attribute definitionin HTML 4.0.

The URI of the linked resource. See thehref attribute definitionin HTML 4.0.

Language code of the linked resource. See thehreflang attribute definitionin HTML 4.0.

Designed for use with one or more target media. See themedia attribute definitionin HTML 4.0.

Forward link type. See therel attribute definitionin HTML 4.0.

Reverse link type. See therev attribute definitionin HTML 4.0.

Frame to render the resource in. See thetarget attribute definitionin HTML 4.0.

Advisory content type. See thetype attribute definitionin HTML 4.0.

The document title. See theTITLE element definitionin HTML 4.0.

The specified title as a string.

This contains generic meta-information about the document. See theMETA element definitionin HTML 4.0.

Associated information. See thecontent attribute definitionin HTML 4.0.

HTTP response header name. See thehttp-equiv attribute definitionin HTML 4.0.

Meta information name. See thename attribute definitionin HTML 4.0.

Select form of content. See thescheme attribute definitionin HTML 4.0.

Document base URI. See theBASE element definitionin HTML 4.0.

The base URI See thehref attribute definitionin HTML 4.0.

The default target frame. See thetarget attribute definitionin HTML 4.0.

This element is used for single-line text input. See theISINDEX element definitionin HTML 4.0. This element is deprecated in HTML 4.0.

Returns theFORMelement containing this control. Returns null if this control is not within the context of a form.

The prompt message. See theprompt attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Style information. A more detailed style sheet object model is planned to be defined in a separate document. See theSTYLE element definitionin HTML 4.0.

Enables/disables the style sheet.

Designed for use with one or more target media. See themedia attribute definitionin HTML 4.0.

The style sheet language (Internet media type). See thetype attribute definitionin HTML 4.0.

The HTML document body. This element is always present in the DOM API, even if the tags are not present in the source document. See theBODY element definitionin HTML 4.0.

Color of active links (after mouse-button down, but before mouse-button up). See thealink attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

URI of the background texture tile image. See thebackground attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Document background color. See thebgcolor attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Color of links that are not active and unvisited. See thelink attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Document text color. See thetext attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Color of links that have been visited by the user. See thevlink attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

TheFORMelement encompasses behavior similar to a collection and an element. It provides direct access to the contained input elements as well as the attributes of the form element. See theFORM element definitionin HTML 4.0.

Returns a collection of all control elements in the form.

The number of form controls in the form.

Names the form.

List of character sets supported by the server. See theaccept-charset attribute definitionin HTML 4.0.

Server-side form handler. See theaction attribute definitionin HTML 4.0.

The content type of the submitted form, generally "application/x-www-form-urlencoded". See theenctype attribute definitionin HTML 4.0.

HTTP method used to submit form. See themethod attribute definitionin HTML 4.0.

Frame to render the resource in. See thetarget attribute definitionin HTML 4.0.

Submits the form. It performs the same action as a submit button.

Restores a form element's default values. It performs the same action as a reset button.

The select element allows the selection of an option. The contained options can be directly accessed through the select element as a collection. See theSELECT element definitionin HTML 4.0.

The type of control created.

The ordinal index of the selected option. The value -1 is returned if no element is selected. If multiple options are selected, the index of the first selected option is returned.

The current form control value.

The number of options in thisSELECT.

Returns theFORMelement containing this control. Returns null if this control is not within the context of a form.

The collection ofOPTIONelements contained by this element.

The control is unavailable in this context. See thedisabled attribute definitionin HTML 4.0.

If true, multipleOPTIONelements may be selected in thisSELECT. See themultiple attribute definitionin HTML 4.0.

Form control or object name when submitted with a form. See thename attribute definitionin HTML 4.0.

Number of visible rows. See thesize attribute definitionin HTML 4.0.

Index that represents the element's position in the tabbing order. See thetabindex attribute definitionin HTML 4.0.

Add a new element to the collection ofOPTIONelements for thisSELECT.

The element to add.

The element to insert before, or NULL for the head of the list.

Remove an element from the collection ofOPTIONelements for thisSELECT. Does nothing if no element has the given index.

The index of the item to remove.

Removes keyboard focus from this element.

Gives keyboard focus to this element.

Group options together in logical subdivisions. See theOPTGROUP element definitionin HTML 4.0.

The control is unavailable in this context. See thedisabled attribute definitionin HTML 4.0.

Assigns a label to this option group. See thelabel attribute definitionin HTML 4.0.

A selectable choice. See theOPTION element definitionin HTML 4.0.

Returns theFORMelement containing this control. Returns null if this control is not within the context of a form.

Stores the initial value of theselectedattribute.

The text contained within the option element.

The index of thisOPTIONin its parentSELECT.

The control is unavailable in this context. See thedisabled attribute definitionin HTML 4.0.

Option label for use in hierarchical menus. See thelabel attribute definitionin HTML 4.0.

Means that this option is initially selected. See theselected attribute definitionin HTML 4.0.

The current form control value. See thevalue attribute definitionin HTML 4.0.

Form control.Note.Depending upon the environment the page is being viewed, the value property may be read-only for the file upload input type. For the "password" input type, the actual value returned may be masked to prevent unauthorized use. See theINPUT element definitionin HTML 4.0.

Stores the initial control value (i.e., the initial value ofvalue).

Whentypehas the value "Radio" or "Checkbox", stores the initial value of thecheckedattribute.

Returns theFORMelement containing this control. Returns null if this control is not within the context of a form.

A comma-separated list of content types that a server processing this form will handle correctly. See theaccept attribute definitionin HTML 4.0.

A single character access key to give access to the form control. See theaccesskey attribute definitionin HTML 4.0.

Aligns this object (vertically or horizontally) with respect to its surrounding text. See thealign attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Alternate text for user agents not rendering the normal content of this element. See thealt attribute definitionin HTML 4.0.

Describes whether a radio or check box is checked, whentypehas the value "Radio" or "Checkbox". The value is TRUE if explicitly set. Represents the current state of the checkbox or radio button. See thechecked attribute definitionin HTML 4.0.

The control is unavailable in this context. See thedisabled attribute definitionin HTML 4.0.

Maximum number of characters for text fields, whentypehas the value "Text" or "Password". See themaxlength attribute definitionin HTML 4.0.

Form control or object name when submitted with a form. See thename attribute definitionin HTML 4.0.

This control is read-only. Whentypehas the value "text" or "password" only. See thereadonly attribute definitionin HTML 4.0.

Size information. The precise meaning is specific to each type of field. See thesize attribute definitionin HTML 4.0.

When thetypeattribute has the value "Image", this attribute specifies the location of the image to be used to decorate the graphical submit button. See thesrc attribute definitionin HTML 4.0.

Index that represents the element's position in the tabbing order. See thetabindex attribute definitionin HTML 4.0.

The type of control created. See thetype attribute definitionin HTML 4.0.

Use client-side image map. See theusemap attribute definitionin HTML 4.0.

The current form control value. Used for radio buttons and check boxes. See thevalue attribute definitionin HTML 4.0.

Removes keyboard focus from this element.

Gives keyboard focus to this element.

Select the contents of the text area. ForINPUTelements whosetypeattribute has one of the following values: "Text", "File", or "Password".

Simulate a mouse-click. ForINPUTelements whosetypeattribute has one of the following values: "Button", "Checkbox", "Radio", "Reset", or "Submit".

Multi-line text field. See theTEXTAREA element definitionin HTML 4.0.

Stores the initial control value (i.e., the initial value ofvalue).

Returns theFORMelement containing this control. Returns null if this control is not within the context of a form.

A single character access key to give access to the form control. See theaccesskey attribute definitionin HTML 4.0.

Width of control (in characters). See thecols attribute definitionin HTML 4.0.

The control is unavailable in this context. See thedisabled attribute definitionin HTML 4.0.

Form control or object name when submitted with a form. See thename attribute definitionin HTML 4.0.

This control is read-only. See thereadonly attribute definitionin HTML 4.0.

Number of text rows. See therows attribute definitionin HTML 4.0.

Index that represents the element's position in the tabbing order. See thetabindex attribute definitionin HTML 4.0.

The type of this form control.

The current textual content of the multi-line text field. If the entirety of the data can not fit into a single wstring, the implementation may truncate the data.

Removes keyboard focus from this element.

Gives keyboard focus to this element.

Select the contents of theTEXTAREA.

Push button. See theBUTTON element definitionin HTML 4.0.

Returns theFORMelement containing this control. Returns null if this control is not within the context of a form.

A single character access key to give access to the form control. See theaccesskey attribute definitionin HTML 4.0.

The control is unavailable in this context. See thedisabled attribute definitionin HTML 4.0.

Form control or object name when submitted with a form. See thename attribute definitionin HTML 4.0.

Index that represents the element's position in the tabbing order. See thetabindex attribute definitionin HTML 4.0.

The type of button. See thetype attribute definitionin HTML 4.0.

The current form control value. See thevalue attribute definitionin HTML 4.0.

Form field label text. See theLABEL element definitionin HTML 4.0.

Returns theFORMelement containing this control. Returns null if this control is not within the context of a form.

A single character access key to give access to the form control. See theaccesskey attribute definitionin HTML 4.0.

This attribute links this label with another form control byidattribute. See thefor attribute definitionin HTML 4.0.

Organizes form controls into logical groups. See theFIELDSET element definitionin HTML 4.0.

Returns theFORMelement containing this control. Returns null if this control is not within the context of a form.

Provides a captionfor aFIELDSETgrouping. See theLEGEND element definitionin HTML 4.0.

Returns theFORMelement containing this control. Returns null if this control is not within the context of a form.

A single character access key to give access to the form control. See theaccesskey attribute definitionin HTML 4.0.

Text alignment relative toFIELDSET. See thealign attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Unordered list. See theUL element definitionin HTML 4.0.

Reduce spacing between list items. See thecompact attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Bullet style. See thetype attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Ordered list. See theOL element definitionin HTML 4.0.

Reduce spacing between list items. See thecompact attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Starting sequence number. See thestart attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Numbering style. See thetype attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Definition list. See theDL element definitionin HTML 4.0.

Reduce spacing between list items. See thecompact attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Directory list. See theDIR element definitionin HTML 4.0. This element is deprecated in HTML 4.0.

Reduce spacing between list items. See thecompact attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Menu list. See theMENU element definitionin HTML 4.0. This element is deprecated in HTML 4.0.

Reduce spacing between list items. See thecompact attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

List item. See theLI element definitionin HTML 4.0.

List item bullet style. See thetype attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Reset sequence number when used inOLSee thevalue attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Generic block container. See theDIV element definitionin HTML 4.0.

Horizontal text alignment. See thealign attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Paragraphs. See theP element definitionin HTML 4.0.

Horizontal text alignment. See thealign attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

For theH1toH6elements. See theH1 element definitionin HTML 4.0.

Horizontal text alignment. See thealign attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

For theQandBLOCKQUOTEelements. See theQ element definitionin HTML 4.0.

A URI designating a document that designates a source document or message. See thecite attribute definitionin HTML 4.0.

Preformatted text. See thePRE element definitionin HTML 4.0.

Fixed width for content. See thewidth attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Force a line break. See theBR element definitionin HTML 4.0.

Control flow of text around floats. See theclear attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Base font. See theBASEFONT element definitionin HTML 4.0. This element is deprecated in HTML 4.0.

Font color. See thecolor attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Font face identifier. See theface attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Font size. See thesize attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Local change to font. See theFONT element definitionin HTML 4.0. This element is deprecated in HTML 4.0.

Font color. See thecolor attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Font face identifier. See theface attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Font size. See thesize attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Create a horizontal rule. See theHR element definitionin HTML 4.0.

Align the rule on the page. See thealign attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Indicates to the user agent that there should be no shading in the rendering of this element. See thenoshade attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

The height of the rule. See thesize attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

The width of the rule. See thewidth attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Notice of modification to part of a document. See theINSandDELelement definitions in HTML 4.0.

A URI designating a document that describes the reason for the change. See thecite attribute definitionin HTML 4.0.

The date and time of the change. See thedatetime attribute definitionin HTML 4.0.

The anchor element. See theA element definitionin HTML 4.0.

A single character access key to give access to the form control. See theaccesskey attribute definitionin HTML 4.0.

The character encoding of the linked resource. See thecharset attribute definitionin HTML 4.0.

Comma-separated list of lengths, defining an active region geometry. See alsoshapefor the shape of the region. See thecoords attribute definitionin HTML 4.0.

The URI of the linked resource. See thehref attribute definitionin HTML 4.0.

Language code of the linked resource. See thehreflang attribute definitionin HTML 4.0.

Anchor name. See thename attribute definitionin HTML 4.0.

Forward link type. See therel attribute definitionin HTML 4.0.

Reverse link type. See therev attribute definitionin HTML 4.0.

The shape of the active area. The coordinates are given bycoords. See theshape attribute definitionin HTML 4.0.

Index that represents the element's position in the tabbing order. See thetabindex attribute definitionin HTML 4.0.

Frame to render the resource in. See thetarget attribute definitionin HTML 4.0.

Advisory content type. See thetype attribute definitionin HTML 4.0.

Removes keyboard focus from this element.

Gives keyboard focus to this element.

Embedded image. See theIMG element definitionin HTML 4.0.

URI designating the source of this image, for low-resolution output.

The name of the element (for backwards compatibility).

Aligns this object (vertically or horizontally) with respect to its surrounding text. See thealign attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Alternate text for user agents not rendering the normal content of this element. See thealt attribute definitionin HTML 4.0.

Width of border around image. See theborder attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Override height. See theheight attribute definitionin HTML 4.0.

Horizontal space to the left and right of this image. See thehspace attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Use server-side image map. See theismap attribute definitionin HTML 4.0.

URI designating a long description of this image or frame. See thelongdesc attribute definitionin HTML 4.0.

URI designating the source of this image. See thesrc attribute definitionin HTML 4.0.

Use client-side image map. See theusemap attribute definitionin HTML 4.0.

Vertical space above and below this image. See thevspace attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Override width. See thewidth attribute definitionin HTML 4.0.

Generic embedded object.Note.In principle, all properties on the object element are read-write but in some environments some properties may be read-only once the underlying object is instantiated. See theOBJECT element definitionin HTML 4.0.

Returns theFORMelement containing this control. Returns null if this control is not within the context of a form.

Applet class file. See thecodeattribute for HTMLAppletElement.

Aligns this object (vertically or horizontally) with respect to its surrounding text. See thealign attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Space-separated list of archives. See thearchive attribute definitionin HTML 4.0.

Width of border around the object. See theborder attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Base URI forclassid,data, andarchiveattributes. See thecodebase attribute definitionin HTML 4.0.

Content type for data downloaded viaclassidattribute. See thecodetype attribute definitionin HTML 4.0.

A URI specifying the location of the object's data. See thedata attribute definitionin HTML 4.0.

Declare (for future reference), but do not instantiate, this object. See thedeclare attribute definitionin HTML 4.0.

Override height. See theheight attribute definitionin HTML 4.0.

Horizontal space to the left and right of this image, applet, or object. See thehspace attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Form control or object name when submitted with a form. See thename attribute definitionin HTML 4.0.

Message to render while loading the object. See thestandby attribute definitionin HTML 4.0.

Index that represents the element's position in the tabbing order. See thetabindex attribute definitionin HTML 4.0.

Content type for data downloaded viadataattribute. See thetype attribute definitionin HTML 4.0.

Use client-side image map. See theusemap attribute definitionin HTML 4.0.

Vertical space above and below this image, applet, or object. See thevspace attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Override width. See thewidth attribute definitionin HTML 4.0.

Parameters fed to theOBJECTelement. See thePARAM element definitionin HTML 4.0.

The name of a run-time parameter. See thename attribute definitionin HTML 4.0.

Content type for thevalueattribute whenvaluetypehas the value "ref". See thetype attribute definitionin HTML 4.0.

The value of a run-time parameter. See thevalue attribute definitionin HTML 4.0.

Information about the meaning of thevalueattribute value. See thevaluetype attribute definitionin HTML 4.0.

An embedded Java applet. See theAPPLET element definitionin HTML 4.0. This element is deprecated in HTML 4.0.

Aligns this object (vertically or horizontally) with respect to its surrounding text. See thealign attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Alternate text for user agents not rendering the normal content of this element. See thealt attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Comma-separated archive list. See thearchive attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Applet class file. See thecode attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Optional base URI for applet. See thecodebase attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Override height. See theheight attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Horizontal space to the left and right of this image, applet, or object. See thehspace attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

The name of the applet. See thename attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Serialized applet file. See theobject attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Vertical space above and below this image, applet, or object. See thevspace attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Override width. See thewidth attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Client-side image map. See theMAP element definitionin HTML 4.0.

The list of areas defined for the image map.

Names the map (for use withusemap). See thename attribute definitionin HTML 4.0.

Client-side image map area definition. See theAREA element definitionin HTML 4.0.

A single character access key to give access to the form control. See theaccesskey attribute definitionin HTML 4.0.

Alternate text for user agents not rendering the normal content of this element. See thealt attribute definitionin HTML 4.0.

Comma-separated list of lengths, defining an active region geometry. See alsoshapefor the shape of the region. See thecoords attribute definitionin HTML 4.0.

The URI of the linked resource. See thehref attribute definitionin HTML 4.0.

Specifies that this area is inactive, i.e., has no associated action. See thenohref attribute definitionin HTML 4.0.

The shape of the active area. The coordinates are given bycoords. See theshape attribute definitionin HTML 4.0.

Index that represents the element's position in the tabbing order. See thetabindex attribute definitionin HTML 4.0.

Frame to render the resource in. See thetarget attribute definitionin HTML 4.0.

Script statements. See theSCRIPT element definitionin HTML 4.0.

The script content of the element.

Reserved for future use.

Reserved for future use.

The character encoding of the linked resource. See thecharset attribute definitionin HTML 4.0.

Indicates that the user agent can defer processing of the script. See thedefer attribute definitionin HTML 4.0.

URI designating an external script. See thesrc attribute definitionin HTML 4.0.

The content type of the script language. See thetype attribute definitionin HTML 4.0.

The create* and delete* methods on the table allow authors to construct and modify tables. HTML 4.0 specifies that only one of each of theCAPTION,THEAD, andTFOOTelements may exist in a table. Therefore, if one exists, and the createTHead() or createTFoot() method is called, the method returns the existing THead or TFoot element. See theTABLE element definitionin HTML 4.0.

Returns the table'sCAPTION, or void if none exists.

Returns the table'sTHEAD, ornullif none exists.

Returns the table'sTFOOT, ornullif none exists.

Returns a collection of all the rows in the table, including all inTHEAD,TFOOT, allTBODYelements.

Returns a collection of the defined table bodies.

Specifies the table's position with respect to the rest of the document. See thealign attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Cell background color. See thebgcolor attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

The width of the border around the table. See theborder attribute definitionin HTML 4.0.

Specifies the horizontal and vertical space between cell content and cell borders. See thecellpadding attribute definitionin HTML 4.0.

Specifies the horizontal and vertical separation between cells. See thecellspacing attribute definitionin HTML 4.0.

Specifies which external table borders to render. See theframe attribute definitionin HTML 4.0.

Specifies which internal table borders to render. See therules attribute definitionin HTML 4.0.

Supplementary description about the purpose or structure of a table. See thesummary attribute definitionin HTML 4.0.

Specifies the desired table width. See thewidth attribute definitionin HTML 4.0.

Create a table header row or return an existing one.

A new table header element (THEAD).

Delete the header from the table, if one exists.

Create a table footer row or return an existing one.

A footer element (TFOOT).

Delete the footer from the table, if one exists.

Create a new table caption object or return an existing one.

ACAPTIONelement.

Delete the table caption, if one exists.

Insert a new empty row in the table.Note.A table row cannot be empty according to HTML 4.0 Recommendation.

The row number where to insert a new row.

The newly created row.

Delete a table row.

The index of the row to be deleted.

Table caption See theCAPTION element definitionin HTML 4.0.

Caption alignment with respect to the table. See thealign attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Regroups theCOLandCOLGROUPelements. See theCOL element definitionin HTML 4.0.

Horizontal alignment of cell data in column. See thealign attribute definitionin HTML 4.0.

Alignment character for cells in a column. See thechar attribute definitionin HTML 4.0.

Offset of alignment character. See thecharoff attribute definitionin HTML 4.0.

Indicates the number of columns in a group or affected by a grouping. See thespan attribute definitionin HTML 4.0.

Vertical alignment of cell data in column. See thevalign attribute definitionin HTML 4.0.

Default column width. See thewidth attribute definitionin HTML 4.0.

TheTHEAD,TFOOT, andTBODYelements.

Horizontal alignment of data in cells. See thealignattribute for HTMLTheadElement for details.

Alignment character for cells in a column. See thechar attribute definitionin HTML 4.0.

Offset of alignment character. See thecharoff attribute definitionin HTML 4.0.

Vertical alignment of data in cells. See thevalignattribute for HTMLTheadElement for details.

The collection of rows in this table section.

Insert a row into this section.

The row number where to insert a new row.

The newly created row.

Delete a row from this section.

The index of the row to be deleted.

A row in a table. See theTR element definitionin HTML 4.0.

The index of this row, relative to the entire table.

The index of this row, relative to the current section (THEAD,TFOOT, orTBODY).

The collection of cells in this row.

Horizontal alignment of data within cells of this row. See thealign attribute definitionin HTML 4.0.

Background color for rows. See thebgcolor attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Alignment character for cells in a column. See thechar attribute definitionin HTML 4.0.

Offset of alignment character. See thecharoff attribute definitionin HTML 4.0.

Vertical alignment of data within cells of this row. See thevalign attribute definitionin HTML 4.0.

Insert an emptyTDcell into this row.

The place to insert the cell.

The newly created cell.

Delete a cell from the current row.

The index of the cell to delete.

The object used to represent theTHandTDelements. See theTD element definitionin HTML 4.0.

The index of this cell in the row.

Abbreviation for header cells. See theabbr attribute definitionin HTML 4.0.

Horizontal alignment of data in cell. See thealign attribute definitionin HTML 4.0.

Names group of related headers. See theaxis attribute definitionin HTML 4.0.

Cell background color. See thebgcolor attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Alignment character for cells in a column. See thechar attribute definitionin HTML 4.0.

Offset of alignment character. See thecharoff attribute definitionin HTML 4.0.

Number of columns spanned by cell. See thecolspan attribute definitionin HTML 4.0.

List ofidattribute values for header cells. See theheaders attribute definitionin HTML 4.0.

Cell height. See theheight attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Suppress word wrapping. See thenowrap attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Number of rows spanned by cell. See therowspan attribute definitionin HTML 4.0.

Scope covered by header cells. See thescope attribute definitionin HTML 4.0.

Vertical alignment of data in cell. See thevalign attribute definitionin HTML 4.0.

Cell width. See thewidth attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Create a grid of frames. See theFRAMESET element definitionin HTML 4.0.

The number of columns of frames in the frameset. See thecols attribute definitionin HTML 4.0.

The number of rows of frames in the frameset. See therows attribute definitionin HTML 4.0.

Create a frame. See theFRAME element definitionin HTML 4.0.

Request frame borders. See theframeborder attribute definitionin HTML 4.0.

URI designating a long description of this image or frame. See thelongdesc attribute definitionin HTML 4.0.

Frame margin height, in pixels. See themarginheight attribute definitionin HTML 4.0.

Frame margin width, in pixels. See themarginwidth attribute definitionin HTML 4.0.

The frame name (object of thetargetattribute). See thename attribute definitionin HTML 4.0.

When true, forbid user from resizing frame. See thenoresize attribute definitionin HTML 4.0.

Specify whether or not the frame should have scrollbars. See thescrolling attribute definitionin HTML 4.0.

A URI designating the initial frame contents. See thesrc attribute definitionin HTML 4.0.

Inline subwindows. See theIFRAME element definitionin HTML 4.0.

Aligns this object (vertically or horizontally) with respect to its surrounding text. See thealign attribute definitionin HTML 4.0. This attribute is deprecated in HTML 4.0.

Request frame borders. See theframeborder attribute definitionin HTML 4.0.

Frame height. See theheight attribute definitionin HTML 4.0.

URI designating a long description of this image or frame. See thelongdesc attribute definitionin HTML 4.0.

Frame margin height, in pixels. See themarginheight attribute definitionin HTML 4.0.

Frame margin width, in pixels. See themarginwidth attribute definitionin HTML 4.0.

The frame name (object of thetargetattribute). See thename attribute definitionin HTML 4.0.

Specify whether or not the frame should have scrollbars. See thescrolling attribute definitionin HTML 4.0.

A URI designating the initial frame contents. See thesrc attribute definitionin HTML 4.0.

Frame width. See thewidth attribute definitionin HTML 4.0.

AnHTMLOptionsCollectionis a list of nodes. An individual node may be accessed by either ordinal index or the node'snameoridattributes.Note:Collections in the HTML DOM are assumed to belivemeaning that they are automatically updated when the underlying document is changed.

This attribute specifies the length orsizeof the list.

This method retrieves a node specified by ordinal index. Nodes are numbered in tree order (depth-first traversal order).

The index of the node to be fetched. The index origin is 0.

TheNodeat the corresponding position upon success. A value ofnullis returned if the index is out of range.

This method retrieves aNodeusing a name. It first searches for aNodewith a matchingidattribute. If it doesn't find one, it then searches for aNodewith a matchingnameattribute, but only on those elements that are allowed a name attribute.

The name of theNodeto be fetched.

TheNodewith anameoridattribute whose value corresponds to the specified string. Upon failure (e.g., no node with this name exists), returnsnull.