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

CKTIS / JavaScript

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

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

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

Синтаксис

list.add(...tokens)
list.remove(...tokens)
list.toggle(token)
list.toggle(token, force)

element.classList предоставя DOMTokenList: динамично множество от уникални токени, което различава главни и малки букви. Промените в списъка обновяват атрибута class, а промените в атрибута се виждат и през по-рано запазена референция към списъка. Тези методи са част от DOM API, а не от ECMAScript; средата за изпълнение трябва да предоставя необходимите DOM API.

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

toggle(token) обръща състоянието на един токен: добавя го, ако липсва, или го премахва, ако присъства. При toggle(token, force) стойността true гарантира присъствие, а false — отсъствие. И двете форми връщат дали токенът присъства след извикването, а не дали е настъпила промяна. Използвайте toggle(token, condition), когато присъствието на токена трябва да следва булево условие.

И при трите метода празен токен предизвиква изключение DOMException с име SyntaxError, а токен, съдържащ знак за празно пространство от набора ASCII — DOMException с име InvalidCharacterError. Използвайте list.add("a", "b"), а не list.add("a b"): аргументите не се разделят на токени.

Примери

{
  function createExampleElement() {
    if (typeof document !== "undefined") {
      return document.createElement("div");
    }

    // Without a DOM, model only the operations used here with valid tokens.
    const tokens = new Set();
    return {
      classList: {
        add(...values) {
          for (const value of values) tokens.add(value);
        },
        remove(...values) {
          for (const value of values) tokens.delete(value);
        },
        toggle(value, force = !tokens.has(value)) {
          if (force) tokens.add(value);
          else tokens.delete(value);
          return tokens.has(value);
        }
      },
      getAttribute(name) {
        return name === "class" ? [...tokens].join(" ") : null;
      }
    };
  }

  const element = createExampleElement();
  const list = element.classList;

  list.add("card", "pending", "card");
  list.remove("pending", "missing");

  console.log(list.toggle("active"));
  console.log(list.toggle("active"));
  console.log(list.toggle("ready", true));
  console.log(list.toggle("active", false));
  console.log(element.getAttribute("class"));
}

Резултат

true
false
true
false
card ready

Изпълнете кода в конзолата на браузъра. Елементът не се вмъква в страницата. Първите два резултата показват добавянето и премахването на `active`. Следващите два показват, че `ready` присъства, а `active` остава извън списъка. Последният ред съдържа стойността на атрибута `class`.

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

  • JavaScript · Урок 7 · Напреднало · Версия: 4
  • JavaScript · Урок 32 · Средно · Версия: 3
  • JavaScript · Урок 34 · Средно · Версия: 3
  • JavaScript · Урок 43 · Средно · Версия: 3

Източници