HOWTO · JavaScript

Cambiar clases CSS en JavaScript

Aprende a cambiar las clases CSS de un elemento con className y classList, incluido un ejemplo controlado por clics.

En esta página

Para cambiar la apariencia de un elemento con JavaScript, selecciónalo y actualiza sus clases. Asigna className cuando quieras reemplazar todo el atributo de clase; usa classList para añadir, eliminar o reemplazar tokens de clase individuales conservando las demás clases. Un detector de clics puede aplicar el cambio en respuesta a una acción del lector.

Varias formas de cambiar la clase CSS en JavaScript

La página completa siguiente asigna al div el ID dimensions y usa clases CSS para controlar su tamaño y su fondo. La clase inicial bg_1 establece un fondo carmesí. Al hacer clic en el elemento, se elimina esa clase y se añade bg_2, que establece un fondo verde azulado. Puedes guardar la página como un archivo HTML y abrirla en un navegador para ver la transición.

Usar la propiedad className

className es una propiedad, no un método. Al asignarle una cadena, se reemplaza el atributo de clase completo del elemento. Por ejemplo, al establecerla en "dimensions bg_2" cambia el fondo y se conserva la clase de tamaño. Si se estableciera solo en "bg_2", también se eliminaría dimensions, así que incluye todas las clases que el elemento debe conservar. Este enfoque es útil cuando quieres definir deliberadamente el conjunto completo de clases, como al aplicar de una vez un grupo conocido de clases de estado.

Usar classList.remove y classList.add

classList es una propiedad que expone métodos para editar tokens de clase individuales. Llama a classList.remove("bg_1") y classList.add("bg_2") para cambiar las clases de fondo sin alterar dimensions ni otras clases no relacionadas. add no duplica un token que ya está presente, y remove solo afecta al token indicado. Usa estas operaciones cuando un elemento tiene clases que deben permanecer en su sitio, incluidas las clases añadidas por otros comportamientos de la página.

Usar el método classList.replace()

classList.replace("bg_1", "bg_2") reemplaza un token por otro y deja intactas las demás clases. El reemplazo solo se produce cuando bg_1 está presente; cuando el token antiguo está ausente, no se cambia ningún token. Elige este método cuando un estado de clase corresponde directamente a otro. Las llamadas separadas a remove y add son útiles cuando quieres hacer explícitas las dos operaciones o cuando el controlador tiene otro trabajo que realizar entre ambas.

Aquí tienes una página HTML completa, con sus estilos, su elemento y su controlador de clics. El pequeño adaptador de JavaScript al final modela la misma interacción de la página para que el ejemplo también tenga un resultado de consola determinista; en un navegador, el script en línea de la página gestiona el clic real.

const html = `<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Change a CSS class</title>
  <style>
    .dimensions { width: 200px; height: 100px; }
    .bg_1 { background-color: crimson; }
    .bg_2 { background-color: teal; }
  </style>
</head>
<body>
  <div id="dimensions" class="dimensions bg_1">Click this box</div>
  <script>
    const element = document.getElementById("dimensions");
    element.addEventListener("click", () => {
      element.classList.remove("bg_1");
      element.classList.add("bg_2");
    });
  </script>
</body>
</html>`;

const element = {
  className: "dimensions bg_1",
  addEventListener(type, handler) {
    this.handler = handler;
  },
  classList: {
    remove(token) {
      element.className = element.className
        .split(" ")
        .filter((name) => name !== token)
        .join(" ");
    },
    add(token) {
      const names = element.className.split(" ");
      if (!names.includes(token)) names.push(token);
      element.className = names.join(" ");
    }
  }
};
const document = { getElementById: () => element };
const selected = document.getElementById("dimensions");
selected.addEventListener("click", () => {
  selected.classList.remove("bg_1");
  selected.classList.add("bg_2");
});
selected.handler();
console.log(selected.className);
dimensions bg_2

La parte del navegador muestra el patrón real del DOM: document.getElementById("dimensions") devuelve el elemento, y addEventListener registra la función de devolución de llamada que se ejecuta con un clic. El adaptador de Node.js reproduce el cambio de tokens de clase para la salida de la consola, ya que Node.js no proporciona de forma predeterminada el DOM de una página. La hoja de estilos determina los colores visibles; cambiar solo un nombre de clase no tiene ningún efecto visual a menos que exista una regla CSS correspondiente. Para un reemplazo completo y directo, usa className e indica todas las clases que se deben conservar. Para un cambio específico que deje intactas las clases de tamaño, diseño y estados no relacionados, usa los métodos de classList. Si tu controlador parece no hacer nada, comprueba que el ID coincide y que ambas clases de fondo están definidas en la hoja de estilos de la página.