CKTIS / JavaScript
Element.getAttribute — odczyt wartości atrybutu
Element.getAttribute odczytuje atrybut elementu DOM jako ciąg znaków lub zwraca null, gdy atrybut nie istnieje.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
element.getAttribute(qualifiedName)element.getAttribute(qualifiedName) zwraca wartość pierwszego atrybutu o podanej nazwie kwalifikowanej. Wynikiem jest ciąg znaków albo null, jeśli atrybut nie istnieje. Pusta wartość to "", nie null; tekst "12" nie jest liczbą. Metoda nie zmienia elementu.
Dla elementów w przestrzeni nazw HTML, należących do dokumentu HTML, nazwa jest przed wyszukiwaniem zamieniana na małe litery ASCII. Poza tym przypadkiem wielkość liter ma znaczenie. Do wyszukiwania według przestrzeni nazw i nazwy lokalnej służy getAttributeNS(namespace, localName).
Przykłady
const element = document.createElement('div');
element.setAttribute('data-count', '12');
element.setAttribute('data-empty', '');
console.log(JSON.stringify([
element.getAttribute('data-count'),
element.getAttribute('data-empty'),
element.getAttribute('data-missing')
]));Wynik
["12","",null]
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.