Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element.className — leggere e sostituire le classi

In un elemento HTML, `className` permette di leggere o sostituire il valore dell’attributo `class`. Il valore è una stringa, non un array di classi. `SVGElement.className` è di sola lettura e restituisce un oggetto `SVGAnimatedString`.

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

Sintassi

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

Element.className rispecchia l’attributo class. Per un elemento HTML, la lettura restituisce il valore dell’attributo come stringa; se l’attributo non è presente, restituisce "".

In un elemento HTML, l’assegnazione element.className = "card selected" imposta l’intero valore dell’attributo. Un’assegnazione successiva sostituisce le classi precedenti invece di aggiungerne una. Separa i nomi delle classi con caratteri di spaziatura ASCII, non con virgole. Uno spazio unificatore (U+00A0) rimane parte di un singolo nome di classe anziché separare due nomi.

SVGElement.className è di sola lettura e restituisce un oggetto SVGAnimatedString, non una stringa.

Usa className per sostituire l’intero insieme di classi di un elemento HTML. Per operare sulle singole classi, usa element.classList, che espone un DOMTokenList. Questa è un’API del DOM, non una funzionalità del linguaggio ECMAScript.

Esempi

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

Risultato

""
card selected
compact

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti