CKTIS / JavaScript
Element.className — leer y sustituir clases
En un elemento HTML, `className` permite leer o sustituir el valor del atributo `class`. Ese valor es una cadena de texto, no un array de clases. `SVGElement.className` es de solo lectura y devuelve un objeto `SVGAnimatedString`.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
// For an HTML element:
element.className
element.className = "class1 class2";Element.className refleja el atributo class. En un elemento HTML, al leerlo se obtiene el valor del atributo como una cadena de texto; si el atributo no existe, se obtiene "".
En un elemento HTML, la asignación element.className = "card selected" establece el valor completo del atributo. Una asignación posterior sustituye las clases anteriores en lugar de añadir otra. Separa los nombres de clase con caracteres de espacio en blanco ASCII, no con comas. Un espacio de no separación (U+00A0) forma parte de un solo nombre de clase en lugar de separar dos nombres.
SVGElement.className es de solo lectura y devuelve un objeto SVGAnimatedString, no una cadena de texto.
Usa className cuando quieras sustituir el conjunto completo de clases de un elemento HTML. Para operar con clases individuales, usa element.classList, que proporciona un DOMTokenList. Esta es una API del DOM, no una característica del lenguaje ECMAScript.
Ejemplos
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);Resultado
"" card selected compact
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.