Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

termin lub wartość HTML: class

Atrybut `class` przypisuje elementowi tokeny używane przez selektory, skrypty i narzędzia; nazwa klasy sama nie nadaje semantyki ani stanu dostępności.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

<p class="note important">…</p>

Wartość class jest listą tokenów rozdzielonych białymi znakami. Interfejs DOMTokenList traktuje powtórzenia jako jeden token, choć surowy tekst atrybutu może początkowo zawierać nadmiarowe odstępy lub duplikaty.

Do operacji na pojedynczych tokenach używaj classList, ponieważ zachowuje granice nazw i waliduje pusty token. className odczytuje lub zastępuje całe serializowane pole, więc łatwo nim przypadkowo usunąć klasy należące do innej funkcji.

Nazwy powinny wyrażać stabilną rolę komponentu albo jawny stan aplikacji. Nie opieraj zachowania wyłącznie na klasach powiązanych z wyglądem i nie używaj zmiany klasy zamiast odpowiednich właściwości ARIA lub natywnych stanów elementu.

Przykład startuje od note note important, wykonuje toggle("important") oraz add("active"), po czym serializacja ma postać note active. Pokazuje to usunięcie tokenu i normalizację listy przez interfejs tokenowy.

Przykłady

<!doctype html><meta charset="utf-8"><p id="x" class="note  note important">Text</p><output id="result"></output><script>x.classList.toggle("important");x.classList.add("active");result.textContent=`tokens=${[...x.classList].join(",")}; serialized=${x.className}`;</script>

Wynik

tokens=note,active; serialized=note active

Wykonany przykład potwierdza deduplikację i zmianę listy klas bez ręcznego dzielenia tekstu atrybutu.

Źródła