En CSS es muy común utilizar múltiples clases CSS para asignar estilos relacionados dependiendo de lo que queramos. Para ello, basta hacer cosas como la que veremos a continuación:
Observa que tenemos un elemento <div>
que tiene las siguientes clases:
<div class="element shine dark-theme"></div>
element
sería la clase general que representa el elemento, y que tiene estilos fijos.shine
podría tener una animación CSS para aplicar un efecto de brillo.dark-theme
podría tener los estilos de un elemento en un tema oscuro.Todo esto se utiliza sin problema de forma estática, pero cuando comenzamos a programar en Javascript, buscamos una forma dinámica, práctica y cómoda de hacerlo desde Javascript, y es de lo que tratará este artículo.
.className
Javascript tiene a nuestra disposición una propiedad .className
en todos los elementos HTML. Dicha propiedad contiene el valor del atributo HTML class
como un
Propiedad | Descripción |
---|---|
.className |
Acceso directo al valor del atributo HTML class . También se puede asignar. |
.classList |
Objeto especial para manejar clases CSS. Contiene métodos y propiedades de ayuda. |
La propiedad .className
viene a ser la modalidad directa y rápida de utilizar el getter .getAttribute("class")
y el setter .setAttribute("class", value)
.
Veamos un ejemplo utilizando estas propiedades y métodos y su equivalencia:
const div = document.querySelector(".element");
// Obtener clases CSS
div.className; // "element shine dark-theme"
div.getAttribute("class"); // "element shine dark-theme"
// Modificar clases CSS
div.className = "element shine light-theme";
div.setAttribute("class", "element shine light-theme");
Trabajar con .className
tiene una limitación cuando trabajamos con múltiples clases CSS, y es que puedes querer realizar una manipulación sólo en una clase CSS concreta, dejando las demás intactas. En ese caso, modificar clases CSS mediante una asignación .className
se vuelve poco práctico.
Probablemente, la forma más interesante de manipular clases CSS desde Javascript es mediante la propiedad .classList
, que es la que veremos a continuación.
.classList
Para trabajar más cómodamente, existe un sistema muy interesante para trabajar con clases: la propiedad u objeto .classList
. Se trata de un objeto especial que contiene una serie de ayudantes que permiten trabajar con las clases de forma más intuitiva y lógica.
Si accedemos a .classList
, nos devolverá un
Método | Descripción |
---|---|
Obtener información | |
.classList |
Devuelve la lista de clases del elemento HTML. |
.classList.length |
Devuelve el número de clases del elemento HTML. |
.classList.item(n) |
Devuelve la clase número n del elemento HTML. |
.classList.contains(clase) |
Indica si la clase existe en el elemento HTML. |
Acciones sobre clases | |
.classList.add(c1, c2, ...) |
Añade las clases c1 , c2 ... al elemento HTML. |
.classList.remove(c1, c2, ...) |
Elimina las clases c1 , c2 ... del elemento HTML. |
.classList.toggle(clase) |
Si la clase no existe, la añade. Si no, la elimina. |
.classList.toggle(clase, expr) |
Si expr es true , añade la clase. Si es false , la elimina. |
.classList.replace(old, new) |
Reemplaza la clase old por la clase new . |
Veamos un ejemplo de uso de cada método de ayuda. Supongamos que tenemos el siguiente elemento HTML en nuestro documento. Vamos a acceder a el y a utilizar el objeto .classList
con dicho elemento:
<div id="page" class="info data dark" data-number="5"></div>
Observa que dicho elemento HTML tiene:
id
info
, data
y dark
data-number
(también es un atributo)Al margen de acceder a la lista de clases mediante .classList
y al número de clases del elemento con .classList.length
, es posible acceder a la propiedad .classList.values
para obtener un .className
:
const element = document.querySelector("#page");
// ¿Qué clases tiene?
element.classList; // ["info", "data", "dark"] (DOMTokenList)
element.classList.value; // "info data dark" (String)
element.classList.length; // 3
// Convertirlas a array
Array.from(element.classList) // ["info", "data", "dark"] (Array)
[...element.classList]; // ["info", "data", "dark"] (Array)
// Consultarlas
element.classList.item(0); // "info"
element.classList.item(1); // "data"
element.classList.item(3); // null
El objeto .classList
aunque parece que devuelve un Array.from()
o desestructuración con [...div.classList]
.
Por último, observa que disponemos del método .classList.item()
que nos devuelve un
Los métodos .classList.add()
y .classList.remove()
permiten indicar una o múltiples clases CSS a añadir o eliminar. Observa el siguiente código donde se ilustra un ejemplo:
const element = document.querySelector("#page");
element.classList.add("uno", "dos");
element.classList; // ["info", "data", "dark", "uno", "dos"]
element.classList.remove("uno", "dos");
element.classList; // ["info", "data", "dark"]
Al utilizar los métodos .add()
o .remove()
, en el caso de que se añada una clase CSS que ya existía previamente, o que se elimine una clase CSS que no existía, simplemente no ocurrirá nada.
Con el método .classList.contains()
podemos comprobar si existe una clase en un elemento HTML, ya que nos devuelve un
const element = document.querySelector("#page");
element.classList; // ["info", "data", "dark"]
element.classList.contains("info"); // Devuelve `true` (existe esa clase)
element.classList.contains("warning"); // Devuelve `false` (no existe esa clase)
Esto puede resultar interesante en algunas situaciones, donde queremos averiguar mediante Javascript si existe una clase.
Otro ayudante muy interesante es el del método .classList.toggle()
, que lo que hace es añadir o eliminar la clase CSS dependiendo de si ya existía previamente. Es decir, añade la clase si no existía previamente o elimina la clase si existía previamente:
const element = document.querySelector("#page");
element.classList; // ["info", "data", "dark"]
element.classList.toggle("info"); // Como "info" existe, lo elimina. Devuelve "false"
element.classList; // ["data", "dark"]
element.classList.toggle("info"); // Como "info" no existe, lo añade. Devuelve "true"
element.classList; // ["info", "data", "dark"]
Observa que .toggle()
devuelve un true
o false
dependiendo de si, tras la operación, la clase sigue existiendo o no. Ten en cuenta que en .toggle()
, al contrario que .add()
o .remove()
, sólo se puede indicar una clase CSS por parámetro.
Por último, tenemos un método .classList.replace()
que nos permite reemplazar la primera clase indicada por parámetro, por la segunda. Veamos este método en acción:
const element = document.querySelector("#page");
element.classList; // ["info", "data", "dark"]
element.classList.replace("dark", "light"); // Devuelve `true` (se hizo el cambio)
element.classList.replace("warning", "error"); // Devuelve `false` (no existe warning)
Con todos estos métodos de ayuda, nos resultará mucho más sencillo manipular clases CSS desde Javascript en nuestro código.
Soy Manz, vivo en Tenerife (España) y soy streamer partner en Twitch y profesor. Me apasiona el universo de la programación web, el diseño y desarrollo web y la tecnología en general. Aunque soy full-stack, mi pasión es el front-end, la terminal y crear cosas divertidas y locas.
Puedes encontrar más sobre mi en Manz.dev