Change Language


Follow Navioo On Twitter

Entity : Node

Represents an entity in an XML Document Type Definition (DTD).

Platform Support

IE Mozilla Netscape Opera Safari
no 1.0+ 6.0+ no no

Constructors

Constructor Action IE Mozilla Netscape Opera Safari
Entity Constructor() : Entity
Represents an entity in an XML Document Type Definition (DTD).
Show Details no 1.0+ 6.0+ no no

Entity() : Entity

Represents an entity in an XML Document Type Definition (DTD).

Returns

Entity
Visibility
internal

Inherited Properties

Property Action IE Mozilla Netscape Opera Safari
attributes : NamedNodeMap
Attributes for an element node.
Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+

For examples, see the Navioo examples page:

http://www.navioo.com/javascript/dhtml/getAttributeNode_Example_4496.html

Remarks

This property returns a listing of all the attributes bound to this Node. Since only Element nodes support attributes, most Node types will return a null value for this property.

NamedNodeMaps are essentially the DOM-equivilant of a hash. This property provides an alternative to the specific Element.getAttribute and Element.hasAttribute methods, which are usually used when you already know which attributes an element has. For those circumstances when you want to do some automatic discovery of attributes and their values, this property provides a convenient way to iterate through the element's attributes.

This property also has the added benefit of being usable across all nodes, not just Element nodes. Therefore no checking needs to be done ahead of time to verify if a node is an Element; rather you can iterate over the attributes list, since any element that has no attributes, or any other DOM node, will have a null value for this property.

Availability

HTML DOM Level 1|HTML DOM Level 2|W3C

childNodes : NodeList
Child nodes of the current node.
Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+

For examples, see the Navioo examples page:

http://www.navioo.com/javascript/dhtml/createTextNode_Example_4484.html

Remarks

The list of nodes that are immediate children of this node. The DOM is a heirarchial structure of Node objects. This property, combined with the parentNode properties provide the basics for defining this structure. Several convenience properties are provided for accessing some frequently-used children nodes, namely the firstChild and lastChild properties.

Since the NodeList class can be referenced as an array as well as its object-oriented interface, one can easily iterate through the contents of a node using standard JavaScript for loops. Because this property is read-only, you cannot alter the NodeList to effect this node's contents. Instead, the methods for addeding and removing nodes should be used, which will result in this being updated automatically.

Availability

HTML DOM Level 1|HTML DOM Level 2|W3C

firstChild : Node
First child node of the current node.
Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+

For examples, see the Navioo examples page:

http://www.navioo.com/javascript/tutorials/TreeWalker_425.htm

Remarks

Returns the first child node from the list of the current node's children. If this node doesn't have any children, a null value will be returned.

This is functionally equivilant to invoking node.childNodes.NodeList.item(0), though this method is much more suscinct and doesn't require any error trapping if the child node doesn't exist.

Availability

HTML DOM Level 1|HTML DOM Level 2|W3C

lastChild : Node
Last child node of the current node.
Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+

For examples, see the Navioo examples page:

http://www.navioo.com/javascript/tutorials/TreeWalker_425.htm

Remarks

Returns the last child node from the list of the current node's children. If this node doesn't have any children, a null value will be returned.

This is functionally equivilant to invoking node.childNodes.NodeList.item(node.childNodes.NodeList.length - 1), though this method is much more suscinct and doesn't require any error trapping if the child node doesn't exist.

Availability

HTML DOM Level 1|HTML DOM Level 2|W3C

localName : String
Local part of an element or attribute name if it the node was defined with an XML Namespace.
Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+
Availability

HTML DOM Level 2|W3C

namespaceURI : String
URI of the namespace for an element or attribute node if the node was defined with an XML Namespace.
Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+
Availability

HTML DOM Level 2|W3C

nextSibling : Node
Sibling node immediately after the current node.
Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+

For examples, see the Navioo examples page:

http://www.navioo.com/javascript/tutorials/TreeWalker_425.htm

Remarks

Returns the next node to the current one within the parent node's children. If this node is the last child within it's parent, then a null value will be returned.

When working with a node, it is often useful to be able to manipulate or search the nodes surrounding it. For instance, if given a node representing a label, you might want to find the text node immediately next to it. To help with this, the nextSibling property allows you to traverse to neighboring nodes in the DOM.

Availability

HTML DOM Level 1|HTML DOM Level 2|W3C

nodeName : String
Name of the node. Same as tag name for element nodes.
Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+

For examples, see the Navioo examples page:

http://www.navioo.com/javascript/tutorials/DOM_Node_403.dhtml

Remarks

This returns a name that represents this node's name. Depending on the type of object this is, this property will either return the name identifying this object; for instance, if this node is a Element or Attr object, then the tag or attribute name is returned. In other cases some place-holder text will be returned.

<property>nodeName</property> node-type valuesTypeleftValueleftAttr Attribute name CDATASection#cdata-sectionComment#commentDocument#documentDocumentFragment#document-fragmentDocumentType Document type name Element Tag name Entity Entity name EntityReference Name of entity referenced Notation Notation name ProcessingInstruction Target Text#text

If XML Namespaces were defined for this node and this node is a Element or Attr object (since these are the only node types that support the use of namespaces), this property returns the node name including the prefix and localName.

Returns an upper case tag name.

Availability

HTML DOM Level 1|HTML DOM Level 2|W3C

nodeType : Number
Type of node. See Remarks for valid values.
Show Details 5.5+ 1.0+ 6.0+ 7.0+ 1.0+
  • IE: IE 5.0 on Windows does not assign nodeType attributes. Fixed in IE 5.5.

For examples, see the Navioo examples page:

http://www.navioo.com/javascript/tutorials/DOM_Node_403.dhtml

Remarks

This property returns an integer indicating what type of DOM Node this object represents.

Because the Node class is inherited by several other, more specific DOM objects, this property is a programmatic way of determining what an arbitrary node is, and therefore can tell the programmer how to interact with it. There are a series of constants defined in this object that can be used to refer to this property:

<property>nodeList</property> constant valuesValuerightConstantleft1ELEMENT_NODE2ATTRIBUTE_NODE3TEXT_NODE4CDATA_SECTION_NODE5ENTITY_REFERENCE_NODE6ENTITY_NODE7PROCESSING_INSTRUCTION_NODE8COMMENT_NODE9DOCUMENT_NODE10DOCUMENT_TYPE_NODE11DOCUMENT_FRAGMENT_NODE12NOTATION_NODE
Availability

HTML DOM Level 1|HTML DOM Level 2|W3C

nodeValue : String
Value of the current node.
Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+

For examples, see the Navioo examples page:

http://www.navioo.com/javascript/tutorials/DOM_Node_403.dhtml

Remarks

This represents the value of the node. Only Attr, CDATASection, Comment, ProcessingInstruction, and Text objects can contain a value in this property. For all other types of objects this property will return null, and setting it to a different value has no effect.

Availability

HTML DOM Level 1|HTML DOM Level 2|W3C

ownerDocument : Document
Document object that contains this node.
Show Details 6.0+ 1.0+ 6.0+ 7.0+ 1.0+

For examples, see the Navioo examples page:

http://www.navioo.com/javascript/tutorials/Document_290.dhtml

Remarks

Refers to the Document object that this node exists in. Because a node must be created as a child of a Document, and since Node objects cannot be moved arbitrarily from one document to another (not without duplicating it), this is a way of referring to the parent document for a node so that document-wide method calls can be used for a node.

Availability

HTML DOM Level 1|HTML DOM Level 2|W3C

parentNode : Node
Parent node of the current node.
Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+

For examples, see the Navioo examples page:

http://www.navioo.com/javascript/tutorials/TreeWalker_425.htm

Remarks

This property contains a reference to the parent node for the current node. Since the DOM is a heirarchial structure of nodes, the parentNode and childNodes properties tie the collection of nodes together.

Not all nodes can have parents however. Attr, Document, DocumentFragment, Entity and Notation objects and as such will contain a null value for this property. As well this property will be null for newly-created nodes that have yet to be added to a location within the DOM tree.

Availability

HTML DOM Level 1|HTML DOM Level 2|W3C

prefix : String
Namespace prefix for an element or attribute node if the node was defined with an XML Namespace.
Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+
Availability

HTML DOM Level 2|W3C

Sibling node immediately before the current node.
Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+

For examples, see the Navioo examples page:

http://www.navioo.com/javascript/tutorials/TreeWalker_425.htm

Remarks
Returns the previous node to the current one within the parent node's children. If this node is the first child within it's parent, then a null value will be returned.
Availability

HTML DOM Level 1|HTML DOM Level 2|W3C

Properties

Property Action IE Mozilla Netscape Opera Safari
notationName : String
Notation name for an unparsed entity.
Show Details no 1.0+ 6.0+ no no
Remarks
If this entity is unparsed, notationName contains the notation name of the entity notation. notationName is null for parsed entities.
Availability

HTML DOM Level 2|W3C

publicId : String
Public identifier for this entity, if specified
Show Details no 1.0+ 6.0+ no no
Remarks
If this entity was defined with a public identifier, then this property will contain that value, otherwise it will return null.
Availability

HTML DOM Level 2|W3C

systemId : String
System identifier for this entity, if specified
Show Details no 1.0+ 6.0+ no no
Remarks
If this entity was defined with a system identifier, then this property will contain that value, otherwise it will return null.
Availability

HTML DOM Level 2|W3C

Inherited Functions

Method Action IE Mozilla Netscape Opera Safari
hasAttributes() : Boolean
Returns true if the node is an element node with attributes.
Show Details no 1.0+ 6.0+ 7.0+ 1.3+

Returns

Boolean

Using hasAttributes

var obj = document.Document.getElementById('EmailAddress');
                        if (obj.hasAttributes()) {
                        window.alert("The node " + obj.Node.nodeName + " has attributes");
                        }

For more examples, see the Navioo examples page:

http://www.navioo.com/javascript/dhtml/getAttributeNode_Example_4496.html

Remarks
Returns true if this node is an Element and has any attributes. Returns false if there are none. Equivilant to checking node.attributes.NamedNodeMap.length > 0.
See Also

Element.getAttribute|Element.hasAttribute|Node.attributes

Availability

HTML DOM Level 1|HTML DOM Level 2|W3C

hasChildNodes() : Boolean
Returns true if the node has child nodes.
Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+

Returns

Boolean

Using hasChildNodes

var obj = document.Document.getElementById('EmailAddress');
                        if (obj.hasChildNodes()) {
                        window.alert("The node " + obj.Node.nodeName + " has children");
                        }
Remarks
Returns true if this node has any child nodes. Returns false if there are none. Equivilant to checking node.childNodes.NodeList.length > 0.
See Also

Node.childNodes

Availability

HTML DOM Level 1|HTML DOM Level 2|W3C

isSupported(String feature, [String version]) : Boolean
Returns true if the specified feature and version are supported.
Show Details no 1.0+ 6.0+ 7.0+ 1.0+

Parameters

String feature Name of the feature.
String version (optional)Version of the feature.

Returns

Boolean
Remarks
Tests whether a node supports the specified feature. Similar to the DOMImplementation.hasFeature method and takes the same feature names. If version is null, returns true if any version of the feature is supported.
See Also

DOMImplementation.hasFeature

Availability

HTML DOM Level 2|W3C

normalize() : void
Merges text nodes adjacent to the element to create a normalized DOM.
Show Details N/A 1.0+ 6.0+ 7.0+ 1.0+
  • IE: May crash IE 6.0.

Returns

void

For examples, see the Navioo examples page:

http://www.navioo.com/javascript/tutorials/Stringsplit_283.html

Remarks
Normalizes any Text nodes contained under this node and all of its children. Merges any adjacent Text nodes into one object, so that the nodes reflect how they would be structured if this XML document were freshly loaded.

Normalize() is useful for manipulating the text content of nodes for editing. Instead of worrying about altering existing Text nodes, you can simply add new nodes and perform the normalize when you finish your updates.

Availability

HTML DOM Level 1|HTML DOM Level 2|W3C

Remarks

This object represents an entity from a Document Type Declaration (DTD). Entities are declarations of abbreviated text or other nodes within an XML document. These can then be inserted at various places in an XML document with EntityReference objects.

While the entity name is stored in the Node.nodeName property, the rest of the entity's data (the actual content of the entity) is stored as children of this object (in the Node.childNodes property). The Node.parentNode for Entity nodes will always be null.

Entity objects are read-only and cannot be modified once they are added to the document or after a document is loaded. If you need to change an entity's contents you should create a new one and change all the EntityReference nodes that referred to the old entity to refer to the new one instead.

References

DocumentType|EntityReference|Notation

Availability

HTML DOM Level 2|W3C

text_javascript Navioo_docs

Ajax Javascript feed

↑ Grab this Headline Animator