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

CKTIS / JavaScript

DOMTokenList: проверка и превключване на токени

`contains()` проверява дали даден токен присъства, без да променя списъка. `toggle()` обръща или задава състоянието му чрез `force` и връща дали токенът присъства след извикването.

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

Синтаксис

tokens.contains(token)
tokens.toggle(token)
tokens.toggle(token, force)

element.classList предоставя DOMTokenList, който отразява текущата стойност на атрибута class на елемента. Тези методи са част от DOM API, а не от ECMAScript 2024. Поддръжката зависи от средата за изпълнение. В браузър примерът използва вградения DOM, а в Node.js — опростен заместител за валидните токени от примера.

tokens.contains(token) връща true, ако списъкът съдържа точно този токен, и false в противен случай. Методът не променя списъка, различава главни от малки букви и не търси поднизове. При празен низ или низ, съдържащ бял знак от набора ASCII (например интервал или табулация), връща false.

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

toggle() приема по един токен. Празният низ предизвиква DOMException с име SyntaxError, а бял знак от набора ASCII в токена предизвиква DOMException с име InvalidCharacterError, дори когато force е false. Подай името на класа без точката от селектора: "active", а не ".active".

Примери

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

    // Node.js has no browser DOM. This stand-in handles the valid tokens used below.
    const classes = new Set([initialClass]);
    return {
      get className() {
        return [...classes].join(" ");
      },
      classList: {
        contains(token) {
          return classes.has(token);
        },
        toggle(token, force) {
          const present = force === undefined ? !classes.has(token) : Boolean(force);
          if (present) classes.add(token);
          else classes.delete(token);
          return present;
        },
      },
    };
  }

  const element = createExampleElement("panel");
  const tokens = element.classList;

  console.log(tokens.contains("active"));
  console.log(tokens.toggle("active"));
  console.log(tokens.toggle("active"));
  console.log(tokens.toggle("active", true));
  console.log(tokens.toggle("active", true));
  console.log(tokens.toggle("active", false));
  console.log(element.className);
}

Резултат

false
true
false
true
true
false
panel

Двете извиквания без `force` първо добавят, а после премахват `active`. И двете извиквания с `true` връщат `true`, въпреки че второто не променя нищо. Извикването с `false` премахва `active` и остава само `panel`.

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

  • JavaScript · Урок 31 · Средно · Версия: 3

Източници