База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

DOMTokenList: добавяне и премахване на токени

Използвай `add()` и `remove()`, за да променяш отделни токени, например имената на класовете на елемент, без да заменяш целия атрибут. Виж кога невалиден токен прекъсва извикването.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

add() и remove() са методи на екземпляр на DOMTokenList — подредено множество от уникални токени, в което главните и малките букви се различават. element.classList връща списък, свързан с атрибута class: промяната на списъка обновява атрибута, а промяната на атрибута се вижда дори чрез по-рано запазена референция към списъка. Други свойства, като HTMLLinkElement.relList, също връщат DOMTokenList.

add() добавя липсващите токени в края, по реда на аргументите, без да създава повторения. remove() премахва съвпадащите токени и пропуска валидните токени, които липсват. И двата метода приемат нула или повече токени и връщат undefined при успех. Без аргументи множеството от токени остава същото, но повторният запис на атрибута може да уеднакви интервалите и да премахне повторенията от текста му.

Подай всяко име на клас като отделен низ: element.classList.add("a", "b"), а не element.classList.add("a b"). Използвай името на класа ("a"), а не CSS селектор (".a"). И двата метода проверяват всички токени, преди да променят списъка. Празен низ ("") предизвиква DOMException с име SyntaxError, а токен с разделителен знак от ASCII, например интервал или табулация, предизвиква InvalidCharacterError. И в двата случая дори валиден токен, подаден по-рано в същото извикване, не се прилага.

element.classList.remove() премахва токени, а не самия елемент. element.remove() отделя елемента от родителския му възел. DOMTokenList е DOM интерфейс на уеб платформата, а не част от ECMAScript 2024. Провери дали целевата среда за изпълнение предоставя необходимите DOM интерфейси.

Примери

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

Резултат

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

Изпълни кода в конзолата на браузъра, за да използваш вграденото свойство `classList`. Елементът не се вмъква в документа. В Node.js примерът използва локален модел на атрибута `class` и показаните операции вместо DOM. Последният ред показва, че след двете неуспешни извиквания `pending` все още липсва, а `card` остава.

Свързани уроци

  • JavaScript · Урок 1 · Напреднало · Версия: 4
  • JavaScript · Урок 2 · Напреднало · Версия: 4
  • JavaScript · Урок 3 · Напреднало · Версия: 4
  • JavaScript · Урок 4 · Напреднало · Версия: 4
  • JavaScript · Урок 5 · Напреднало · Версия: 4
  • JavaScript · Урок 6 · Напреднало · Версия: 4
  • JavaScript · Урок 8 · Напреднало · Версия: 4
  • JavaScript · Урок 12 · Напреднало · Версия: 4
  • JavaScript · Урок 13 · Напреднало · Версия: 4
  • JavaScript · Урок 16 · Напреднало · Версия: 4
  • JavaScript · Урок 18 · Напреднало · Версия: 4
  • JavaScript · Урок 19 · Напреднало · Версия: 4
  • JavaScript · Урок 22 · Напреднало · Версия: 4
  • JavaScript · Урок 23 · Напреднало · Версия: 4
  • JavaScript · Урок 26 · Напреднало · Версия: 4
  • JavaScript · Урок 28 · Напреднало · Версия: 4
  • JavaScript · Урок 29 · Напреднало · Версия: 4
  • JavaScript · Урок 32 · Напреднало · Версия: 4
  • JavaScript · Урок 33 · Напреднало · Версия: 4
  • JavaScript · Урок 36 · Напреднало · Версия: 4
  • JavaScript · Урок 37 · Напреднало · Версия: 4
  • JavaScript · Урок 39 · Напреднало · Версия: 4
  • JavaScript · Урок 40 · Напреднало · Версия: 4
  • JavaScript · Урок 41 · Напреднало · Версия: 4
  • JavaScript · Урок 45 · Напреднало · Версия: 4
  • JavaScript · Урок 27 · Средно · Версия: 3
  • JavaScript · Урок 28 · Средно · Версия: 3
  • JavaScript · Урок 29 · Средно · Версия: 3
  • JavaScript · Урок 30 · Средно · Версия: 3
  • JavaScript · Урок 35 · Средно · Версия: 3
  • JavaScript · Урок 38 · Средно · Версия: 3
  • JavaScript · Урок 39 · Средно · Версия: 3
  • JavaScript · Урок 41 · Средно · Версия: 3
  • JavaScript · Урок 42 · Средно · Версия: 3

Източници