CKTIS / JavaScript
Element.className — odczyt i zastępowanie klas
W elemencie HTML właściwość `className` pozwala odczytać lub zastąpić wartość atrybutu `class` jako ciąg znaków, a nie tablicę klas. Właściwość `SVGElement.className` jest tylko do odczytu i zwraca obiekt `SVGAnimatedString`.
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
// For an HTML element:
element.className
element.className = "class1 class2";Element.className odzwierciedla atrybut class. Dla elementu HTML odczyt zwraca jego wartość jako ciąg znaków; gdy atrybut nie istnieje, zwraca "".
W elemencie HTML przypisanie element.className = "card selected" ustawia całą wartość atrybutu. Kolejne przypisanie zastępuje poprzednie klasy, zamiast dopisywać nową. Nazwy klas rozdziela się białymi znakami ASCII, nie przecinkami. Spacja nierozdzielająca (U+00A0) nie rozdziela nazw klas, lecz pozostaje częścią jednej nazwy.
Właściwość SVGElement.className jest tylko do odczytu i zwraca obiekt SVGAnimatedString, a nie ciąg znaków.
Używaj className, gdy chcesz zastąpić cały zestaw klas elementu HTML. Do operacji na pojedynczych klasach służy element.classList, udostępniające DOMTokenList. To API DOM, nie funkcja samego ECMAScript.
Przykłady
const element = document.createElement("div");
console.log(JSON.stringify(element.className));
element.className = "card selected";
console.log(element.getAttribute("class"));
element.className = "compact";
console.log(element.className);Wynik
"" card selected compact
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.