Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

DOMTokenList: aggiungere e rimuovere token

Usa `add()` e `remove()` per modificare singoli token, come i nomi delle classi di un elemento, senza sostituire l’intero attributo. Scopri quando un token non valido fa fallire la chiamata.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

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

add() e remove() sono metodi di istanza di DOMTokenList, un insieme ordinato di token univoci che distingue tra maiuscole e minuscole. element.classList restituisce una lista collegata all’attributo class: modificare la lista aggiorna l’attributo, e le modifiche all’attributo sono visibili anche tramite un riferimento alla lista salvato in precedenza. Anche altre proprietà, come HTMLLinkElement.relList, restituiscono una DOMTokenList.

add() accoda i token mancanti nell’ordine degli argomenti, senza creare duplicati. remove() elimina i token corrispondenti e ignora quelli validi ma assenti. Entrambi i metodi accettano zero o più token e restituiscono undefined se la chiamata va a buon fine. Senza argomenti, l’insieme dei token non cambia, ma la riscrittura dell’attributo può uniformare la spaziatura ed eliminare i duplicati dal suo testo.

Passa ogni nome di classe come una stringa separata: element.classList.add("a", "b"), non element.classList.add("a b"). Usa il nome di classe ("a"), non un selettore CSS (".a"). Entrambi i metodi verificano tutti i token prima di modificare la lista. Una stringa vuota ("") genera una DOMException chiamata SyntaxError; un token contenente un carattere di spaziatura ASCII, come uno spazio o una tabulazione, genera InvalidCharacterError. In entrambi i casi non viene applicato nemmeno un token valido che precede quello non valido nella stessa chiamata.

element.classList.remove() rimuove i token, non l’elemento stesso. element.remove() scollega l’elemento dal nodo genitore. DOMTokenList è un’interfaccia DOM della piattaforma web, non una parte di ECMAScript 2024. Verifica che l’ambiente di esecuzione di destinazione fornisca le API DOM necessarie.

Esempi

{
  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));
        },
      },
    };
  }
}

Risultato

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

Esegui il codice nella console del browser per usare la proprietà nativa `classList`. L’elemento non viene inserito nel documento. In Node.js, l’esempio usa un modello locale dell’attributo `class` e delle operazioni mostrate al posto del DOM. L’ultima riga mostra che, dopo entrambe le chiamate fallite, `pending` è ancora assente e `card` è ancora presente.

Lezioni correlate

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

Fonti