Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Element.className — čtení a nahrazování tříd

U prvku HTML lze pomocí `className` přečíst nebo nahradit hodnotu atributu `class`. Touto hodnotou je řetězec, nikoli pole tříd. Vlastnost `SVGElement.className` je jen pro čtení a vrací objekt `SVGAnimatedString`.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

// For an HTML element:
element.className
element.className = "class1 class2";

Element.className odráží atribut class. U prvku HTML vrací čtení hodnotu atributu jako řetězec; pokud atribut chybí, vrátí "".

U prvku HTML nastaví přiřazení element.className = "card selected" celou hodnotu atributu. Další přiřazení předchozí třídy nahradí, místo aby přidalo novou. Názvy tříd oddělujte bílými znaky ASCII, nikoli čárkami. Nezalomitelná mezera (U+00A0) zůstává součástí jediného názvu třídy a neodděluje dva názvy.

Vlastnost SVGElement.className je jen pro čtení a vrací objekt SVGAnimatedString, nikoli řetězec.

className použijte, když chcete nahradit celou sadu tříd prvku HTML. Pro práci s jednotlivými třídami slouží element.classList, které zpřístupňuje DOMTokenList. Jde o API DOM, nikoli o funkci jazyka ECMAScript.

Příklady

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);

Výsledek

""
card selected
compact

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje