CKTIS / JavaScript
Element.classList — gestionar las clases de un elemento
Element.classList proporciona un DOMTokenList activo para leer y modificar clases individuales sin reemplazar todo el atributo class.
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
element.classList
element.classList.add(...tokens)
element.classList.remove(...tokens)
element.classList.contains(token)
element.classList.toggle(token, force)
element.classList.replace(token, newToken)Element.classList devuelve el mismo DOMTokenList activo: los cambios en el atributo class se reflejan en él. Contiene tokens únicos en orden. Si no hay clases, la lista está vacía.
add(...tokens) añade clases sin duplicados, remove(...tokens) elimina las clases indicadas y contains(token) comprueba si una clase está presente. Pasa argumentos separados, no una única cadena con espacios.
toggle(token) alterna la presencia; el argumento opcional force fuerza la adición (true) o la eliminación (false). El resultado indica si el token está presente al final. replace(token, newToken) devuelve si se realizó el reemplazo.
Los métodos que modifican la lista rechazan un token vacío con SyntaxError y los espacios en blanco ASCII dentro de un token con InvalidCharacterError; ambos son excepciones DOMException. Esta es una API del DOM, no una característica de ECMAScript; Node 24 no demuestra que sea compatible con los navegadores.
Ejemplos
const element = document.createElement('div');
const classes = element.classList;
classes.add('card', 'selected');
classes.add('card');
classes.toggle('selected', false);
classes.replace('card', 'panel');
console.log(element.className);
console.log(classes.contains('selected'));
element.className = 'ready';
console.log(classes.contains('ready'));Resultado
panel false true
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.