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.