Element: getAttributeNS()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die getAttributeNS()-Methode der Element-Schnittstelle gibt den Zeichenfolgenwert des angegebenen Namespaced-Attributs des angegebenen Elements zurück. Sie gibt null zurück, wenn das Element kein Attribut mit dem angegebenen Namen im Namespace hat.
Wenn Sie mit HTML-Dokumenten arbeiten und Sie das angeforderte Attribut nicht als Teil eines bestimmten Namespaces angeben müssen, verwenden Sie stattdessen die getAttribute()-Methode.
Syntax
getAttributeNS(namespace, localName)
Parameter
Rückgabewert
Eine Zeichenfolge, die den Wert des Attributs enthält, oder null, wenn das Element kein Attribut mit dem angegebenen Namen hat.
Beispiele
Das folgende SVG-Dokument liest den Wert des foo-Attributs in einem benutzerdefinierten Namespace.
<svg xmlns="http://www.w3.org/2000/svg"
xmlns:test="http://www.example.com/2014/test" width="40" height="40">
<circle id="target" cx="12" cy="12" r="10" stroke="#444444"
stroke-width="2" fill="none" test:foo="Hello namespaced attribute!"/>
<script>
const ns = 'http://www.example.com/2014/test';
const circle = document.getElementById('target');
console.log(`attribute test:foo: "${circle.getAttributeNS(ns, 'foo')}"`);
</script>
</svg>
In einem HTML-Dokument muss auf das Attribut mit test:foo zugegriffen werden, da Namespaces nicht unterstützt werden.
<svg
xmlns="http://www.w3.org/2000/svg"
xmlns:test="http://www.example.com/2014/test"
width="40"
height="40">
<circle
id="target"
cx="12"
cy="12"
r="10"
stroke="#444444"
stroke-width="2"
fill="none"
test:foo="Foo value" />
</svg>
const ns = "http://www.example.com/2014/test";
const circle = document.getElementById("target");
console.log(`Attribute value: ${circle.getAttribute("test:foo")}`);
Spezifikationen
| Spezifikation |
|---|
| DOM # ref-for-dom-element-getattributens① |