Change Language


Follow Navioo On Twitter

DocumentFragment : Node

Light-weight implementation of Document.

Platform Support

IE Mozilla Netscape Opera Safari
3.0+ 1.0+ 2.0+ 7.0+ 1.0+

Constructors

Constructor Action IE Mozilla Netscape Opera Safari
Light-weight implementation of Document.
Show Details 3.0+ 1.0+ 2.0+ 7.0+ 1.0+

DocumentFragment() : Node

Light-weight implementation of Document.

Returns

Node
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

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 is a lightweight Document object that is used when the standard Document interface is too heavy to use. The Range object uses DocumentFragment objects extensively, so that it can extract and store ranges of DOM nodes without creating an entirely new document.

A DocumentFragment behaves like a conventional Node with all of the same methods, except that a DocumentFragment does not have to be fully-formed XML and can be used to represent partly-formed or subsets of documents.

References

Range

Availability

HTML DOM Level 2|W3C

text_javascript Navioo_docs

Examples -> Source code Demo online - > documentfragment:

Ajax Javascript feed

↑ Grab this Headline Animator