Element

This is a temporary page to pull together an example of what the ideal end state will be. It includes some content from MDN that is not compatible with the WPD license, and should be removed soon.

Based on: https://developer.mozilla.org/en-US/docs/DOM/Element and http://msdn.microsoft.com/en-us/library/ie/hh772117(v=vs.85).aspx

Summary

Element is a DOM interface that forms the basis of the API for DOM objects. Other interfaces, like HTMLElement or SVGElement, will sub-class from Element and add new parts of the API.

Overview Table

Implementation note: The Others… should be a template that calls out that this is a work item. Slash just include them automatically.

||
|Inherits from|Node|
|Sub-interfaces|HTMLElement, SVGElement, Incomplete list…|

Properties

Implementation Note: The summaries would be automatically transcluded from the page

Implementation Note: The list of these would be automatically generated.

Name	Summary
`children`	Children is all of the children of a node.
`parentNode`	parentNode is the parent of the node.
Many, many others…

Methods

Implementation Note: The summaries would be automatically transcluded from the page

Implementation Note: The list of these would be automatically generated.

Name	Summary
`appendChild(element)`	Node.appendChild() adds a node to the end of the list of children of a specified parent node. If the node already exists it is removed from current parent node, then added to new parent node.
`insertBefore(element)`	Node.appendChild() adds a node to the end of the list of children of a specified parent node. If the node already exists it is removed from current parent node, then added to new parent node.
`replaceChild(element)`	Node.appendChild() adds a node to the end of the list of children of a specified parent node. If the node already exists it is removed from current parent node, then added to new parent node.
Many, many others…

Events

//LANGUAGE-TAG: JavaScript
//Create a div and append it to the body.
var oDiv=document.createElement("DIV");
document.body.appendChild(oDiv);

Usage

If child</child> is a reference to an existing node in the document, <code>appendChild moves it from its current position to the new position (i.e. there is no requirement to remove the node from its parent node before appending it to some other node).

This also means that a node can’t be in two points of the document simultaneously. So if the node already has a parent, it is first removed, then appended at the new position.

You can use cloneNode to make a copy of the node before appending it under the new parent. (Note that the copies made with cloneNode will not be automatically kept in sync.)

This method is not allowed to move nodes between different documents. If you want to appendNode from a different document (for example to display results from AJAX request) you must first use importNode.

appendChild() is one of the fundamental methods of web programming using the DOM. The appendChild() method inserts a new node into the DOM structure of a document, and is the second part of the one-two, create-and-append process so central to building web pages programmatically.

This method is accessible at run time. If elements are removed at run time, before the closing tag is parsed, areas of the document might not render.

Specifications

Specification	Status	Relevant changes
DOM Level 3 Core	Recommendation	Original specification

Browser Compatibility

Implementation Note: Would have the Compatibility_Incomplete flag

Desktop

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari
Basic support	Supported (when?)	Supported (when?)	Supported (when?)	Supported(when?)	Supported(when?)

Mobile

Feature	Android	Firefox Mobile (Gecko)	IE Phone	Opera Mobile	Safari Mobile
Basic support	Supported (when?)	Supported (when?)	Supported (when?)	Supported (when?)	Supported (when?)

Compatibility Notes

Browser	Version	Note
Internet Explorer	6+	This method now applies to the attribute object.
Internet Explorer	9+	Exceptions are only supported when webpages are displayed in IE9 Standards mode.