null, insert newChild at the end of the list of children.
@param newChild The node to insert
@param refChild The reference node (that is, the node before which the newnode must be inserted), or null
@return The node being inserted
newChild before the existing child node refChild. If refChild is null, insert newChild at the end of the list of children. newChild is a DocumentFragment object, all of its children are inserted, in the same order, before refChild. If the newChild is already in the tree, it is first removed. Note: Inserting a node before itself is implementation dependent.
@param newChild The node to insert.
@param refChild The reference node, i.e., the node before which the new node must be inserted.
@return The node being inserted.
@exception DOMException HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not allow children of the type of the newChild node, or if the node to insert is one of this node's ancestors or this node itself, or if this node is of type Document and the DOM application attempts to insert a second DocumentType or Element node.
WRONG_DOCUMENT_ERR: Raised if newChild was created from a different document than the one that created this node.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly or if the parent of the node being inserted is readonly.
NOT_FOUND_ERR: Raised if refChild is not a child of this node.
NOT_SUPPORTED_ERR: if this node is of type Document, this exception might be raised if the DOM implementation doesn't support the insertion of a DocumentType or Element node.
@since DOM Level 3
null if ungrouped
@throws IllegalArgumentException if the node or element is null, or if the node is not part of this rewriter's AST, or if the inserted node is not a new node (or placeholder), or if element is not a member of the list (original or new), or if the described modification is otherwise invalid
null if ungrouped
@throws IllegalArgumentException if the node or element is null,or if the node is not part of this rewriter's AST, or if the inserted node is not a new node (or placeholder), or if element is not a member of the list (original or new), or if the described modification is otherwise invalid
Adds a new children to the node, positioned just before another child node that is also specified.
This method is effectively equivalent to first searching the existing child and then executing {@link #insertChild(int,Node)}specifying its position.
@param existingChild the child we want to insert the new child just before. @param newChild the new child.newChild before the existing child node refChild . If refChild is null , insert newChild at the end of the list of children. newChild is a DocumentFragment object, all of its children are inserted, in the same order, before refChild . If the newChild is already in the tree, it is first removed.
@param newChild The node to insert.
@param refChild The reference node, i.e., the node before which the new node must be inserted.
@return The node being inserted.
@exception DOMException HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not allow children of the type of the newChild node, or if the node to insert is one of this node's ancestors. newChild was created from a different document than the one that created this node. refChild is not a child of this node.
You could use {@link #setParent} or {@link #appendChild}instead of this method, unless you want to control where to put the child.
Note: {@link #setParent} always calls back {@link #insertBefore}and/or {@link #removeChild}, while {@link #insertBefore} and {@link #removeChild}always calls back {@link #setParent}, if the parent is changed. Thus, you don't need to override both {@link #insertBefore} and {@link #setParent}, if you want to customize the behavior. @param newChild the new child to be inserted. @param refChild the child before which you want the new childbeing inserted. If null, the new child is append to the end. @return true if newChild is added successfully or moved;false if it already has the specified child and the order doesn't change.
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |