CKTIS / JavaScript
DOMTokenList.toggle() — przełączanie tokenu
DOMTokenList.toggle() przełącza obecność tokenu lub wymusza ją argumentem force. Zwraca informację o obecności tokenu po wywołaniu.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
tokenList.toggle(token)
tokenList.toggle(token, force)DOMTokenList.toggle() działa na liście tokenów, np. element.classList. Bez force dodaje nieobecny token albo usuwa obecny. Przekaż jeden token, nie ciąg kilku klas oddzielonych spacjami.
force równe true zapewnia obecność tokenu, a false — jego brak. Powtórzenie tej samej wymuszonej operacji nie odwraca stanu. Wynik to true, jeśli token jest obecny po wywołaniu, lub false, jeśli go nie ma; nie informuje, czy nastąpiła zmiana.
Pusty token powoduje DOMException o nazwie SyntaxError; białe znaki ASCII w tokenie powodują InvalidCharacterError. To API DOM, nie funkcja samego ECMAScript. Przykład wymaga przeglądarkowego DOM.
Przykłady
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));Wynik
[true,false,true,true,false] ""
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.