| DOM Reference Manual | All Packages | All Classes | Index | Frames No Frames | | |
| Comment | Properties | Methods | Events | Constants | ||
| Package | dom.core |
| Class | public class Comment |
| Inheritance | Comment  CharacterData Node Object |
| Introduced in: | DOM 1 Core |
Although it is generally not displayed, it is still available to be read in the source view. These are represented in HTML and XML as content between <!-- and --> . In XML, the character sequence "--" cannot be used within a comment.
See also
| Property | Defined By | ||
|---|---|---|---|
 | DOM 1 Core attributes : NamedNodeMap [read-only]
Returns an unordered collection of Attr nodes. | Node | |
| Non-Standard baseName : DOMString [read-only]
Returns the base name for the name qualified with the namespace. | Node | |
| DOM 3 Core baseURI : DOMString [read-only]
The absolute base URI of this node or null if the implementation
wasn't able to obtain an absolute URI. | Node | |
| DOM 1 Core childNodes : NodeList [read-only]
Returns an ordered collection of node objects that are children of
the current element. | Node | |
| DOM 1 Core data : DOMString
The character data of the node that implements this interface. | CharacterData | |
| Non-Standard dataType : *
Specifies the data type for this node. | Node | |
| Non-Standard definition : Node [read-only]
Returns the definition of the node in the document type definition (DTD) or schema. | Node | |
| DOM 1 Core firstChild : Node [read-only]
Returns the node's first child in the tree, or null if the node is
childless. | Node | |
| DOM 1 Core lastChild : Node [read-only]
Returns the last child of a node. | Node | |
| DOM 1 Core length : Number [read-only]
The number of 16-bit units that are available through data and the
substringData method below. | CharacterData | |
| DOM 2 Core localName : DOMString [read-only]
Returns the local part of the qualified name of this node. | Node | |
| DOM 2 Core namespaceURI : DOMString [read-only]
The namespace URI of the node, or null if it is unspecified (read-only). | Node | |
| DOM 1 Core nextSibling : Node [read-only]
Returns the node immediately following the specified one in its
parent's childNodes list, or null if the specified node is the
last node in that list. | Node | |
| DOM 1 Core nodeName : DOMString [read-only]
Returns the name of the current node as a string. | Node | |
| Non-Standard nodePrincipal : nsIPrincipal [read-only]
Returns the nsIPrincipal object representing current security
context of the node. | Node | |
| DOM 1 Core nodeType : Number [read-only]
Returns an integer code representing the type of the node. | Node | |
| Non-Standard nodeTypedValue : *
Contains the node value expressed in its defined data type. | Node | |
| Non-Standard nodeTypeString : DOMString [read-only]
Returns the node type in string form. | Node | |
| DOM 1 Core nodeValue : DOMString
Returns or sets the value of the current node. | Node | |
| DOM 1 Core ownerDocument : Document [read-only]
The Document object associated with this node. | Node | |
| DOM 1 Core parentNode : Node [read-only]
Returns the parent of the specified node in the DOM tree. | Node | |
| Non-Standard parsed : Boolean [read-only]
Indicates the parsed status of the node and child nodes. | Node | |
| DOM 2 Core prefix : DOMString
Returns the namespace prefix of the specified node, or null if no
prefix is specified. | Node | |
| DOM 1 Core previousSibling : Node [read-only]
Returns the node immediately preceding the specified one in its
parent's childNodes list, null if the specified node is the first
in that list. | Node | |
| Non-Standard specified : Boolean [read-only]
Indicates whether the node (usually an attribute) is explicitly specified or derived
from a default value in the document type definition (DTD) or schema. | Node | |
| Non-Standard text : DOMString
Represents the text content of the node or the concatenated text representing the node and its descendants. | Node | |
| DOM 3 Core textContent : DOMString
Gets or sets the text content of a node and its descendants. | Node | |
| Non-Standard xml : DOMString [read-only]
Contains the XML representation of the node and all its descendants. | Node | |
| Method | Defined By | ||
|---|---|---|---|
|
Associates a function with a particular event and binds the event to the current node. | Node | |
| DOM 3 Events addEventListenerNS(namespaceURI:DOMString, type:DOMString, listener:EventListener, useCapture:Boolean):void
Registers an event listener, depending on the useCapture parameter, on the
capture phase of the DOM event flow or its target and bubbling phases. | Node | |
|
Adds a node to the end of the list of children of a specified parent node. | Node | |
|
Append the string to the end of the character data of the node. | CharacterData | |
|
Returns a duplicate of the current node. | Node | |
|
Compares the position of the current node against another node in any other document. | Node | |
| DOM 1 Core deleteData(offset:Number, count:Number):void
Remove a range of 16-bit units from the node. | CharacterData | |
|
Dispatches an event to fire on a node artificially. | Node | |
|
This method returns a specialized object which implements the
specialized APIs of the specified feature and version, as specified
in DOM Features. | Node | |
|
Retrieves the object associated to a key on a this node. | Node | |
| DOM 2 Core hasAttributes():Boolean
Returns a boolean value of true or false, indicating if the current element
has any attributes or not. | Node | |
| DOM 1 Core hasChildNodes():Boolean
Returns a value that indicates whether the object has children. | Node | |
|
Inserts the specified node before a reference element as a child of
the current node. | Node | |
|
Insert a string at the specified 16-bit unit offset. | CharacterData | |
|
Returns true if the namespace is the default namespace on the given
node or false if not. | Node | |
|
Tests whether two nodes are equal. | Node | |
|
Returns whether this node is the same node as the given one. | Node | |
|
Tests whether the DOM implementation implements a specific feature
and that feature is supported by this node. | Node | |
|
Takes a prefix and returns the namespaceURI associated with it on the
given node if found (and null if not). | Node | |
|
Returns the prefix for a given namespaceURI if present, and null if not. | Node | |
| DOM 1 Core normalize():void
Puts the specified node and all of its subtree into a "normalized"
form. | Node | |
|
Removes a child node from the object. | Node | |
|
Removes an event listener. | Node | |
| DOM 3 Events removeEventListenerNS(namespaceURI:DOMString, type:DOMString, listener:EventListener, useCapture:Boolean):void
Removes an event listener. | Node | |
|
Replaces an existing child element with a new child element. | Node | |
|
Replace the characters starting at the specified 16-bit unit offset
with the specified string. | CharacterData | |
|
Applies the specified pattern-matching operation to this node's context and returns the list of matching nodes as IXMLDOMNodeList. | Node | |
|
Applies the specified pattern-matching operation to this node's context and returns the first matching node. | Node | |
|
Associate an object to a key on this node. | Node | |
|
Extracts a range of data from the node. | CharacterData | |
|
Processes this node and its children using the supplied Extensible Stylesheet Language Transformations
(XSLT) style sheet and returns the resulting transformation. | Node | |
|
Processes this node and its children using the supplied Extensible Stylesheet Language Transformations (XSLT) style sheet
and returns the resulting transformation. | Node | |
| Event | Summary | Defined By | ||
|---|---|---|---|---|
| Occurs after CharacterData.data or ProcessingInstruction.data have been modified but the node itself has not been inserted or deleted. | CharacterData | ||
| A node has been added as a child of another node or, in case of Attr nodes, has been added to an Element. | CharacterData | ||
| A node has been inserted into a document, either through direct insertion of the node or insertion of a subtree in which it is contained; Attr nodes are considered part of an Element's subtree. | CharacterData | ||
| A node is being removed from its parent node or, in case of Attr nodes, removed from its ownerElement. | CharacterData | ||
| A node is being removed from a document, either through direct removal of the node or removal of a subtree in which it is contained; Attr nodes are considered part of an Element's subtree. | CharacterData | ||
| Constant | Defined By | ||
|---|---|---|---|
| DOM 1 Core ATTRIBUTE_NODE : Number = 2 [static]
The node is an Attr. | Node | |
| DOM 1 Core CDATA_SECTION_NODE : Number = 4 [static]
The node is a CDATASection. | Node | |
| DOM 1 Core COMMENT_NODE : Number = 8 [static]
The node is a Comment. | Node | |
| DOM 1 Core DOCUMENT_FRAGMENT_NODE : Number = 11 [static]
The node is a DocumentFragment. | Node | |
| DOM 1 Core DOCUMENT_NODE : Number = 9 [static]
The node is a Document. | Node | |
| DOM 3 Core DOCUMENT_POSITION_CONTAINED_BY : Number = 16 [static]
The node is contained by the reference node. | Node | |
| DOM 3 Core DOCUMENT_POSITION_CONTAINS : Number = 8 [static]
The node contains the reference node. | Node | |
| DOM 3 Core DOCUMENT_POSITION_DISCONNECTED : Number = 1 [static]
The two nodes are disconnected. | Node | |
| DOM 3 Core DOCUMENT_POSITION_FOLLOWING : Number = 4 [static]
The node follows the reference node. | Node | |
| DOM 3 Core DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC : Number = 32 [static]
The determination of preceding versus following is implementation-specific. | Node | |
| DOM 3 Core DOCUMENT_POSITION_PRECEDING : Number = 2 [static]
The second node precedes the reference node. | Node | |
| DOM 1 Core DOCUMENT_TYPE_NODE : Number = 10 [static]
The node is a DocumentType. | Node | |
| DOM 1 Core ELEMENT_NODE : Number = 1 [static]
The node is an Element. | Node | |
| DOM 1 Core ENTITY_NODE : Number = 6 [static]
The node is an Entity. | Node | |
| DOM 1 Core ENTITY_REFERENCE_NODE : Number = 5 [static]
The node is an EntityReference. | Node | |
| DOM 1 Core NOTATION_NODE : Number = 12 [static]
The node is a Notation. | Node | |
| DOM 1 Core PROCESSING_INSTRUCTION_NODE : Number = 7 [static]
The node is a ProcessingInstruction. | Node | |
| DOM 1 Core TEXT_NODE : Number = 3 [static]
The node is a Text node. | Node | |
Hide Inherited Public Properties
Show Inherited Public Properties