Dokument: createElementNS() Methode
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
* Some parts of this feature may have varying levels of support.
Erstellt ein Element mit dem angegebenen Namespace-URI und qualifizierten Namen.
Um ein Element ohne Angabe eines Namespace-URI zu erstellen, verwenden Sie die
createElement() Methode.
Syntax
createElementNS(namespaceURI, qualifiedName)
createElementNS(namespaceURI, qualifiedName, options)
Parameter
namespaceURI-
Ein String, der den dem Element zuzuordnenden
namespaceURIangibt. Einige wichtige Namespace-URIs sind: qualifiedName-
Ein String, der den Typ des zu erstellenden Elements angibt. Die
nodeNameEigenschaft des erstellten Elements wird mit dem Wert von qualifiedName initialisiert. optionsOptional-
Ein optionales
ElementCreationOptionsObjekt, das eine einzige Eigenschaft namensisenthält, deren Wert der Tag-Name für ein zuvor mitcustomElements.define()definiertes benutzerdefiniertes Element ist. Aus Gründen der Rückwärtskompatibilität erlauben einige Browser, dass Sie hier statt eines Objekts einen String übergeben, wobei der Wert des Strings der Tag-Name des benutzerdefinierten Elements ist. Siehe Erweitern von nativen HTML-Elementen für weitere Informationen zur Verwendung dieses Parameters.Das neue Element erhält ein
isAttribut, dessen Wert der Tag-Name des benutzerdefinierten Elements ist. Benutzerdefinierte Elemente sind eine experimentelle Funktion, die nur in einigen Browsern verfügbar ist.
Rückgabewert
Das neue Element.
Ausnahmen
NamespaceErrorDOMException-
Wird ausgelöst, wenn der Wert von
namespaceURIkein gültiger Namespace-URI ist. InvalidCharacterErrorDOMException-
Wird ausgelöst, wenn der Wert von
qualifiedNamekein gültiger XML-Name ist; zum Beispiel, wenn er mit einer Zahl, einem Bindestrich oder einem Punkt beginnt oder Zeichen enthält, die keine alphanumerischen Zeichen, Unterstriche, Bindestriche oder Punkte sind.
Beispiele
Dies erstellt ein neues <div> Element im XHTML Namespace und hängt es an das vbox Element an. Obwohl dies kein äußerst nützliches XUL-Dokument ist, demonstriert es die Verwendung von Elementen aus zwei verschiedenen Namespaces innerhalb eines einzelnen Dokuments:
<?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><![CDATA[
let container;
let newDiv;
let textNode;
function init() {
container = document.getElementById("ContainerBox");
newDiv = document.createElementNS("http://www.w3.org/1999/xhtml", "div");
textNode = document.createTextNode(
"This is text that was constructed dynamically with createElementNS and createTextNode then inserted into the document using appendChild.",
);
newDiv.appendChild(textNode);
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>
Hinweis: Das oben gegebene Beispiel verwendet Inline-Script, das in XHTML-Dokumenten nicht empfohlen wird. Dieses spezielle Beispiel ist tatsächlich ein XUL-Dokument mit eingebettetem XHTML, jedoch gilt die Empfehlung weiterhin.
Spezifikationen
| Specification |
|---|
| DOM # ref-for-dom-document-createelementns① |
Browser-Kompatibilität
Loading…