Indicates a comment that is not displayed.
Members
The comment object has these types of members:
Events
The comment object has these events.
| Event | Description |
|---|---|
| abort |
Fires when the user aborts the download. |
| change |
Fires when the contents of the object or selection have changed. |
| error |
Fires when an error occurs during object loading. |
| input |
Occurs when the text content of an element is changed through the user interface. |
| load |
Fires immediately after the client loads the object. |
| onselect |
Fires when the current selection changes. |
| readystatechange |
Fires when the state of the object has changed. |
| reset |
Fires when the user resets a form. |
| resize |
Fires when the size of the object is about to change. |
Methods
The comment object has these methods.
| Method | Description |
|---|---|
| appendChild |
Appends an element as a child to the object. |
| appendData |
Adds a new character string to the end of the object. |
| applyElement |
Makes the element either a child or parent of another element. |
| clearAttributes |
Removes all attributes and values from the object. |
| cloneNode |
Copies a reference to the object from the document hierarchy. |
| componentFromPoint |
Returns the component located at the specified coordinates via certain events. |
| deleteData |
Removes a specified range of characters from the object. |
| doScroll |
Simulates a click on a scroll bar component. |
| dragDrop |
Initiates a drag event. |
| getAdjacentText |
Returns the adjacent text string. |
| getAttribute |
Retrieves the value of the specified attribute. |
| getAttributeNode |
Retrieves an attribute object referenced by the attribute.name property. |
| getAttributeNodeNS |
Gets an attribute object that matches the specified namespace and name. |
| getAttributeNS |
Gets the value of the specified attribute within the specified namespace. |
| getBoundingClientRect |
Retrieves an object that specifies the bounds of a collection of TextRectangle objects. |
| getClientRects |
Retrieves a collection of rectangles that describes the layout of the contents of an object or range within the client. Each rectangle describes a single line. |
| getElementsByClassName |
Gets a collection of objects that are based on the value of the class attribute. |
| getElementsByTagNameNS |
Gets a collection of objects that are based on the specified element names within a specified namespace. |
| hasAttribute |
Determines whether an attribute with the specified name exists. |
| hasAttributeNS |
Determines whether an attribute that has the specified namespace and name exists. |
| hasAttributes |
Determines whether one or more attributes exist for the object. |
| hasChildNodes |
Returns a value that indicates whether the object has children. |
| insertAdjacentElement |
Inserts an element at the specified location. |
| insertBefore |
Inserts an element into the document hierarchy as a child node of a parent object. |
| insertData |
Inserts a new character string in the object at a specified offset. |
| mergeAttributes |
Copies all read/write attributes to the specified element. |
| msMatchesSelector |
Determines whether an object matches the specified selector. |
| normalize |
Merges adjacent DOM objects to produce a normalized document object model. |
| removeAttribute |
Removes an attribute from an object. |
| removeAttributeNode |
Removes an attribute object from the object. |
| removeAttributeNS |
Removes the specified attribute from the object. |
| removeChild |
Removes a child node from the object. |
| removeNode |
Removes the object from the document hierarchy. |
| replaceAdjacentText |
Replaces the text adjacent to the element. |
| replaceChild |
Replaces an existing child element with a new child element. |
| replaceData |
Replaces a specified range of characters in the object with a new character string. |
| replaceNode |
Replaces the object with another element. |
| scrollIntoView |
Causes the object to scroll into view, aligning it either at the top or bottom of the window. |
| setActive |
Sets the object as active without setting focus to the object. |
| setAttribute |
Sets the value of the specified attribute. |
| setAttributeNode |
Sets an attribute object node as part of the object. |
| setAttributeNodeNS |
Sets an attribute object as part of the object. |
| setAttributeNS |
Sets the value of the specified attribute within the specified namespace. |
| setCapture |
Sets the mouse capture to the object that belongs to the current document. |
| substringData |
Extracts a range of characters from the object. |
| swapNode |
Exchanges the location of two objects in the document hierarchy. |
Properties
The comment object has these properties.
| Property | Description |
|---|---|
|
Retrieves a collection of attributes of the object. | |
|
Gets a value indicating whether the object can contain child objects. | |
|
Retrieves the value indicating whether the object can contain rich HTML markup. | |
|
Retrieves the number of immediate child nodes of the current element or a zero if the element does not contain any child nodes. childElementCount does not return all child nodes, only child nodes that are nodeType =1, or element nodes. | |
|
Returns a reference to the constructor of an object. | |
|
Sets or retrieves the URL that references the data of the object. | |
|
Gets a reference to the first child in the childNodes collection of the object. | |
|
Retrieves a reference to the first child element, or null if there are no child elements. | |
|
Sets or retrieves the string identifying the object. | |
|
Gets the value that indicates whether the user can edit the contents of the object. | |
|
Gets the value that indicates whether the user can interact with the object. | |
|
Retrieves the value indicating whether the content of the object contains one or more lines. | |
|
Gets a reference to the last child in the childNodes collection of an object. | |
|
Retrieves a reference to the last child element or null if there are no child elements. | |
|
Sets or retrieves the number of objects in a collection. | |
|
Retrieves a reference to the sibling element that immediately follows or null if the element does not have any sibling elements that follow it. | |
|
Retrieves a reference to the next child of the parent for the object. | |
|
Gets the name of a particular type of node. | |
|
Retrieves the type of the requested node. | |
|
Gets or sets the value of a node. | |
|
Retrieves the document object associated with the node. | |
|
Retrieves the parent object in the document hierarchy. | |
|
Retrieves a reference to the immediately preceding sibling element or null if the element does not have any preceding siblings. | |
|
Gets a reference to the previous child of the parent for the object. | |
|
Retrieves the current state of the object. | |
|
Sets or retrieves the role for this element. | |
|
Retrieves or sets the text of the object as a string. | |
|
Retrieves an autogenerated, unique identifier for the object. |
Standards information
There are no standards that apply here.
Remarks
The COMMENT element is treated as a no-scope element and does not expose any children.
See also
Build date: 11/28/2012