Javascript [Electronic resources] : The Definitive Guide (4th Edition) نسخه متنی

Availability

DOM Level 1 Core

Synopsis

Node appendChild(Node newChild)
throws DOMException;

Arguments

newChild

The node to be inserted into the document. If the node is a
DocumentFragment, it is not directly inserted, but each of its
children are.

Returns

The node that was added.

Throws

This method may throw a DOMException with one of the following
code values in the following circumstances:

HIERARCHY_REQUEST_ERR

The node does not allow children, or it does not allow children of
the specified type, or newChild is an
ancestor of this node (or is this node itself ).

WRONG_DOCUMENT_ERR

The ownerDocument property of
newChild is not the same as the
ownerDocument property of this node.

NO_MODIFICATION_ALLOWED_ERR

This node is read-only and does not allow children to be appended, or
the node being appended is already part of the document tree and its
parent is read-only and does not allow children to be removed.

Description

This method adds the node newChild to the
document, inserting it as the last child of this node. If
newChild is already in the document tree,
it is removed from the tree and then reinserted at its new location.
If newChild is a DocumentFragment node, it
is not inserted itself; instead, all its children are appended, in
order, to the end of this node's
childNodes[] array. Note that a node from (or
created by) one document cannot be inserted into a different
document. That is, the ownerDocument property of
newChild must be the same as the
ownerDocument property of this node.

Example

The following function inserts a new paragraph at the end of the
document:

function appendMessage(message) {
var pElement = document.createElement("P");
var messageNode = document.createTextNode(message);
pElement.appendChild(messageNode);    // Add text to paragraph
document.body.appendChild(pElement);  // Add paragraph to document body
}

See Also

Node.insertBefore( ), Node.removeChild( ), Node.replaceChild( )