Element#
Element.getAttributeNS()#
Metoda getAttributeNS() zwraca wartość z atrybutu o określonej przestrzeni nazw i nazwie lokalnej w danym elemencie. W przypadku braku pasującego atrybutu zwrócona zostanie wartość null.
Opis działania#
Samo wywołanie i poszczególne jego części najlepiej objaśnić na zapisie składniowym:
var attr_value = element.getAttributeNS(namespace, localName);gdzie poszczególne człony oznaczają:
- attr_value - łańcuch znakowy reprezentujący wartość poszukiwanego atrybutu w elemencie lub wartość
null. - element - węzeł będący obiektem kontekstu.
- namespace - łańcuch znakowy reprezentujący przestrzeń nazw, do której należy poszukiwany atrybut w elemencie. Wartość
nullma identyczne działanie jak przekazanie pustego łańcucha znakowego. - localName - łańcuch znakowy reprezentujący nazwę lokalną poszukiwanego atrybutu w elemencie.
Algorytm wywołania metody getAttributeNS(namespace, localName) nie jest skomplikowany. Dla lepszego zrozumienia tematu prezentuję go w całości:
- Niech attr będzie wynikiem pobrania atrybutu poprzez przestrzeń nazw i nazwę lokalną z przekazaniem namespace, localName i obiektu kontekstu.
- Jeśli attr jest wartością
null, to zwróć wartośćnull. - Zwróć wartość z attr.
Alternatywnie można skorzystać z podobnie działających metod Element.getAttributeNodeNS() lub NamedNodeMap.getNamedItemNS() w połączeniu z kilkoma dodatkowymi linijkami kodu.
Prosty przykład:
<!DOCTYPE html>
<html>
<head>
<script>
function getNamedItemNS(namespace, localName){
var p = document.getElementsByTagName("p")[0]; // referencja do akapitu
p.setAttributeNS("ns1", "ID", "Test1");
p.setAttribute("id", "Identyfikator");
p.setAttributeNS("ns2", "A:NEW", "Test2");
var allAttr = p.attributes;
var attr = allAttr.getNamedItemNS(namespace, localName); // atrybut o określonej przestrzeni nazw i nazwie lokalnej
var info = document.getElementById("info");
info.innerHTML = "Metoda getAttributeNS('" + namespace + "','" + localName + "'): " + p.getAttributeNS(namespace, localName)
+ "<br>" + "Metoda hasAttributeNS('" + namespace + "','" + localName + "'): " + p.hasAttributeNS(namespace, localName)
info.innerHTML += "<br><br>" + "Porównanie z metodą getNamedItemNS('" + namespace + "," + localName + "'): "
+ "<br><br>" + "Interfejs mapy nazwanych atrybutów: " + allAttr // [object NamedNodeMap]
+ "<br>" + "Właściwość length: " + allAttr.length;
if (attr){
info.innerHTML += "<br><br>" + "Interfejs atrybutu: " + attr
+ "<br>" + "Pierwszy argument z metody: " + namespace
+ "<br>" + "Drugi argument z metody: " + localName
+ "<br>" + "Właściwość namespaceURI: " + attr.namespaceURI
+ "<br>" + "Właściwość prefix: " + attr.prefix
+ "<br>" + "Właściwość localName: " + attr.localName
+ "<br>" + "Właściwość name: " + attr.name
+ "<br>" + "Właściwość value: " + attr.value;
}
else{
info.innerHTML += "<br><br>Wartość: " + String(attr)
+ "<br>" + "Pierwszy argument z metody: " + namespace
+ "<br>" + "Drugi argument z metody: " + localName;
}
}
</script>
</head>
<body>
<p>Akapit z atrybutami ustawianymi z poziomu skryptu:</p>
<ul>
<li>p.setAttributeNS("ns1", "ID", "Test1");</li>
<li>p.setAttribute("id", "Identyfikator");</li>
<li>p.setAttributeNS("ns2", "A:NEW", "Test2");</li>
</ul>
<p>Kliknij przycisk by pobrać wartość atrybutu o określonej przestrzeni nazw i nazwie lokalnej z akapitu.</p>
<input type="button" value="getAttributeNS('ns1','ID')" onclick="getNamedItemNS('ns1','ID')">
<input type="button" value="getAttributeNS('','ID')" onclick="getNamedItemNS('','ID')">
<input type="button" value="getAttributeNS(null,'id')" onclick="getNamedItemNS(null,'id')">
<input type="button" value="getAttributeNS('','id')" onclick="getNamedItemNS('','id')">
<input type="button" value="getAttributeNS('ns2','NEW')" onclick="getNamedItemNS('ns2','NEW')">
<input type="button" value="getAttributeNS('ns2','new')" onclick="getNamedItemNS('ns2','new')">
<input type="button" value="getAttributeNS('ns2','A:NEW')" onclick="getNamedItemNS('ns2','A:NEW')">
<p style="color: blue;">Szczegółowe informacje dla pobranych atrybutów:</p>
<p id="info"></p>
</body>
</html>Na chwilę obecną jedynie przeglądarki Firefox i Chrome obsługują metodę getAttributeNS() zgodnie z najnowszymi wymaganiami specyfikacji DOM4. IE wiele aspektów związanych z atrybutami obsługuje błędnie.
Składnia Web IDL#
interface Element : Node { DOMString? getAttributeNS(DOMString? namespace, DOMString localName); }
Specyfikacje i inne materiały#
Pasek społecznościowy