Книга: JavaScript. Подробное руководство, 6-е издание

DOMTokenList

DOMTokenList

множество лексем, разделенных пробелами

Объект DOMTokenList представляет результат разбора строки со списком лексем, разделенных пробелами как, например, свойство className объекта Element. Объект DOMTokenList, как следует из его имени, является списком, точнее объектом, подобным массиву, со свойством length, который можно индексировать для получения доступа к отдельным лексемам. Но более важно, что он определяет методы contains(), add(), remove() и toggle(), позволяющие работать с ним как со множеством лексем. Если использовать объект DOMTokenList в строковом контексте, он будет интерпретироваться как строка со списком лексем, разделенных пробелами.

Свойство classList объектов Element, определяемое спецификацией HTML5, является объектом DOMTokenList в броузерах, поддерживающих это свойство. И это единственный объект DOMTokenList, который вам наверняка придется часто использовать на практике. См. также DOMSettableTokenList.

Свойства

readonly unsigned long length
DOMTokenList - это объект, подобный массиву; данное свойство определяет количество уникальных лексем, содержащихся в нем.

Методы

void add(string token)

Если DOMTokenList еще не содержит лексему token, она будет добавлена в конец списка.

boolean contains(string token)

Возвращает true, если объект DOMTokenList содержит лексему token, или false -в противном случае.

string item(unsigned long index)

Возвращает лексему по указанному индексу или null, если индекс index выходит за границы массива. Объект DOMTokenList можно также индексировать непосредственно, не прибегая к этому методу,

void remove(string token)

Если DOMTokenList содержит лексему token, этот метод удалит ее. Иначе он ничего делать не будет,

boolean toggle(string token)

Если DOMTokenList содержит лексему token, этот метод удалит ее. Иначе - добавит.

Оглавление книги