25.214. Node.insertBefore( ): insert a node into the document tree before the specified nodeDOM Level 1 Core25.214.1. SynopsisNode insertBefore(Node newChild, Node refChild) throws DOMException; 25.214.1.1. Arguments
25.214.1.2. ReturnsThe node that was inserted. 25.214.1.3. ThrowsThis method may throw a DOMException with the following code values:
25.214.2. DescriptionThis method inserts the node newChild into the document tree as a child of this node. The new node is positioned within this node's childNodes[] array so that it comes immediately before the refChild node. If refChild is null, newChild is inserted at the end of childNodes[], just as with the appendChild( ) method. Note that it is illegal to call this method with a refChild that is not a child of this node. If newChild is already in the document tree, it is removed from the tree and then reinserted at its new position. If newChild is a DocumentFragment node, it is not inserted itself; instead, each of its children is inserted, in order, at the specified location. 25.214.3. ExampleThe following function inserts a new paragraph at the beginning of a document: function insertMessage(message) { var paragraph = document.createElement("p"); // Create a <p> Element var text = document.createTextNode(message); // Create a Text node paragraph.appendChild(text); // Add text to the paragraph // Now insert the paragraph before the first child of the body document.body.insertBefore(paragraph, document.body.firstChild) } 25.214.4. See AlsoNode.appendChild( ), Node.removeChild( ), Node.replaceChild( ) |