Creates an element with the specified namespace URI and qualified name.
To create an element without specifying a namespace URI, use the createElement()
method.
Syntax
var element = document.createElementNS(namespaceURI, qualifiedName[, options]);
Parameters
- namespaceURI
- A string that specifies the namespace URI to associate with the element. The
namespaceURI
property of the created element is initialized with the value of namespaceURI. See Valid Namespace URIs. - qualifiedName
- A string that specifies the type of element to be created. The
nodeName
property of the created element is initialized with the value of qualifiedName. - optionsOptional
- An optional
ElementCreationOptions
object containing a single property namedis
, whose value is the tag name for a custom element previously defined usingcustomElements.define()
. For backwards compatibility with previous versions of the Custom Elements specification, some browsers will allow you to pass a string here instead of an object, where the string's value is the custom element's tag name. See Extending native HTML elements for more information on how to use this parameter. - The new element will be given an
is
attribute whose value is the custom element's tag name. Custom elements are an experimental feature only available in some browsers.
Return value
The new Element
.
Important Namespace URIs
- HTML
http://www.w3.org/1999/xhtml
- SVG
http://www.w3.org/2000/svg
- MathML
http://www.w3.org/1998/Math/MathML
- XUL
http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul
- XBL
http://www.mozilla.org/xbl
Example
This creates a new <div> element in the XHTML namespace and appends it to the vbox element. Although this is not an extremely useful XUL document, it does demonstrate the use of elements from two different namespaces within a single document:
<?xml version="1.0"?> <page xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul" xmlns:html="http://www.w3.org/1999/xhtml" title="||Working with elements||" onload="init()"> <script type="application/javascript"><![CDATA[ let container; let newdiv; let txtnode; function init(){ container = document.getElementById("ContainerBox"); newdiv = document.createElementNS("http://www.w3.org/1999/xhtml", "div"); txtnode = document.createTextNode("This is text that was constructed dynamically with createElementNS and createTextNode then inserted into the document using appendChild."); newdiv.appendChild(txtnode); container.appendChild(newdiv); } ]]></script> <vbox id="ContainerBox" flex="1"> <html:div> The script on this page will add dynamic content below: </html:div> </vbox> </page>
The example given above uses inline script which is not recommended in XHTML documents. This particular example is actually an XUL document with embedded XHTML, however, the recommendation still applies.
Specifications
Specification | Status | Comment |
---|---|---|
DOM The definition of 'Document.createElementNS()' in that specification. |
Living Standard |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
createElementNS | Chrome Full support 1 | Edge Full support 12 | Firefox
Full support
Yes
| IE Full support 9 | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android Full support Yes | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes |
options parameter | Chrome
Full support
56
| Edge
Full support
≤79
| Firefox
Full support
50
| IE ? | Opera
Full support
43
| Safari ? | WebView Android
Full support
56
| Chrome Android
Full support
56
| Firefox Android
Full support
50
| Opera Android
Full support
43
| Safari iOS ? | Samsung Internet Android
Full support
6.0
|
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown
- See implementation notes.
- See implementation notes.