Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

DOMTokenList: añadir y eliminar tokens

Usa `add()` y `remove()` para modificar tokens concretos, como los nombres de clase de un elemento, sin sustituir todo el atributo. Aprende cuándo un token no válido hace fallar la llamada.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

tokenList.add(...tokens);
tokenList.remove(...tokens);

add() y remove() son métodos de instancia de DOMTokenList, un conjunto ordenado de tokens únicos que distingue entre mayúsculas y minúsculas. element.classList devuelve una lista vinculada al atributo class: editar la lista actualiza el atributo, y editar el atributo se refleja incluso en una referencia a la lista guardada anteriormente. Otras propiedades, como HTMLLinkElement.relList, también devuelven una DOMTokenList.

add() añade al final los tokens que faltan, en el orden de los argumentos y sin crear duplicados. remove() elimina los tokens coincidentes e ignora los tokens válidos que no están presentes. Ambos métodos aceptan cero o más tokens y devuelven undefined si la llamada tiene éxito. Sin argumentos, el conjunto de tokens no cambia, pero al volver a escribir el atributo se pueden normalizar los espacios y eliminar duplicados de su texto.

Pasa cada nombre de clase como una cadena independiente: element.classList.add("a", "b"), no element.classList.add("a b"). Usa el nombre de clase ("a"), no un selector CSS (".a"). Ambos métodos validan todos los tokens antes de cambiar la lista. Una cadena vacía ("") provoca una DOMException llamada SyntaxError; un token con un carácter de espacio en blanco ASCII, como un espacio o una tabulación, provoca InvalidCharacterError. En ambos casos, ni siquiera se aplica un token válido que aparezca antes en la misma llamada.

element.classList.remove() elimina tokens, no el propio elemento. element.remove() separa el elemento de su nodo padre. DOMTokenList es una interfaz DOM de la plataforma web, no una parte de ECMAScript 2024. Comprueba que el entorno de ejecución de destino ofrece las API del DOM que necesitas.

Ejemplos

{
  const card = typeof document === "undefined"
    ? createClassOnlyCard()
    : document.createElement("div");
  card.setAttribute("class", "card is-loading");
  const tokens = card.classList;

  tokens.add("is-active", "is-ready", "is-active");
  console.log(card.getAttribute("class"));

  tokens.remove("is-loading", "missing");
  console.log(card.getAttribute("class"));

  try {
    tokens.add("pending", "two words");
  } catch (error) {
    console.log(error.name);
  }

  try {
    tokens.remove("card", "");
  } catch (error) {
    console.log(error.name);
  }

  console.log(card.getAttribute("class"));

  // Without a DOM, model only the class attribute and the operations used here.
  function createClassOnlyCard() {
    let value = null;
    const asciiWhitespace = /[\t\n\f\r ]+/;

    function update(tokens, apply) {
      for (const token of tokens) {
        if (token === "") {
          throw new DOMException("A token must not be empty.", "SyntaxError");
        }
        if (asciiWhitespace.test(token)) {
          throw new DOMException("A token must not contain ASCII whitespace.", "InvalidCharacterError");
        }
      }

      const classes = new Set((value ?? "").split(asciiWhitespace).filter(Boolean));
      for (const token of tokens) apply(classes, token);
      if (value !== null || classes.size > 0) value = [...classes].join(" ");
    }

    return {
      setAttribute(name, text) {
        if (name === "class") value = String(text);
      },
      getAttribute(name) {
        return name === "class" ? value : null;
      },
      classList: {
        add(...tokens) {
          update(tokens, (classes, token) => classes.add(token));
        },
        remove(...tokens) {
          update(tokens, (classes, token) => classes.delete(token));
        },
      },
    };
  }
}

Resultado

card is-loading is-active is-ready
card is-active is-ready
InvalidCharacterError
SyntaxError
card is-active is-ready

Ejecuta el código en la consola del navegador para usar la propiedad nativa `classList`. El elemento no se inserta en el documento. En Node.js, el ejemplo utiliza un modelo local del atributo `class` y de las operaciones mostradas en lugar del DOM. La última línea muestra que, tras las dos llamadas fallidas, `pending` sigue ausente y `card` sigue presente.

Lecciones relacionadas

  • JavaScript · Lección 1 · Avanzado · Versión: 4
  • JavaScript · Lección 2 · Avanzado · Versión: 4
  • JavaScript · Lección 3 · Avanzado · Versión: 4
  • JavaScript · Lección 4 · Avanzado · Versión: 4
  • JavaScript · Lección 5 · Avanzado · Versión: 4
  • JavaScript · Lección 6 · Avanzado · Versión: 4
  • JavaScript · Lección 8 · Avanzado · Versión: 4
  • JavaScript · Lección 12 · Avanzado · Versión: 4
  • JavaScript · Lección 13 · Avanzado · Versión: 4
  • JavaScript · Lección 16 · Avanzado · Versión: 4
  • JavaScript · Lección 18 · Avanzado · Versión: 4
  • JavaScript · Lección 19 · Avanzado · Versión: 4
  • JavaScript · Lección 22 · Avanzado · Versión: 4
  • JavaScript · Lección 23 · Avanzado · Versión: 4
  • JavaScript · Lección 26 · Avanzado · Versión: 4
  • JavaScript · Lección 28 · Avanzado · Versión: 4
  • JavaScript · Lección 29 · Avanzado · Versión: 4
  • JavaScript · Lección 32 · Avanzado · Versión: 4
  • JavaScript · Lección 33 · Avanzado · Versión: 4
  • JavaScript · Lección 36 · Avanzado · Versión: 4
  • JavaScript · Lección 37 · Avanzado · Versión: 4
  • JavaScript · Lección 39 · Avanzado · Versión: 4
  • JavaScript · Lección 40 · Avanzado · Versión: 4
  • JavaScript · Lección 41 · Avanzado · Versión: 4
  • JavaScript · Lección 45 · Avanzado · Versión: 4
  • JavaScript · Lección 27 · Intermedio · Versión: 3
  • JavaScript · Lección 28 · Intermedio · Versión: 3
  • JavaScript · Lección 29 · Intermedio · Versión: 3
  • JavaScript · Lección 30 · Intermedio · Versión: 3
  • JavaScript · Lección 35 · Intermedio · Versión: 3
  • JavaScript · Lección 38 · Intermedio · Versión: 3
  • JavaScript · Lección 39 · Intermedio · Versión: 3
  • JavaScript · Lección 41 · Intermedio · Versión: 3
  • JavaScript · Lección 42 · Intermedio · Versión: 3

Fuentes