Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła