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

CKTIS / JavaScript

DOMTokenList.toggle() — превключване на токен

DOMTokenList.toggle() превключва наличието на токен или го задава принудително чрез force. Връща информация дали токенът е наличен след извикването.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

tokenList.toggle(token)
tokenList.toggle(token, force)

DOMTokenList.toggle() работи със списък от токени, например element.classList. Без аргумент force методът добавя липсващ token или премахва наличен. Подайте един токен, а не няколко класа, разделени с интервали.

Когато force е зададен на true, наличието на токена се гарантира; при false се гарантира липсата му. Повтарянето на една и съща принудително зададена операция не обръща състоянието. Резултатът е true, ако токенът е наличен след извикването, или false, ако липсва. Той не показва дали е настъпила промяна.

Празен токен предизвиква DOMException с име SyntaxError; ASCII интервалите в токена причиняват InvalidCharacterError. Това е DOM API, а не вградена функция на ECMAScript. Примерът изисква DOM в браузър.

Примери

const element = document.createElement('div');
const tokens = element.classList;
const results = [
  tokens.toggle('active'),
  tokens.toggle('active'),
  tokens.toggle('active', true),
  tokens.toggle('active', true),
  tokens.toggle('active', false)
];
console.log(JSON.stringify(results));
console.log(JSON.stringify(element.className));

Резултат

[true,false,true,true,false]
""

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници