HTML DOM classListСвойство
Примеры
Добавьте класс к элементу <div>:
Попробуйте сами »
Определение и использование
Свойство classList возвращает имя (имена) класса элемента в виде объекта DOMTokenList.
Это свойство используется для добавления, удаления и переключения CSS-классов у элемента.
Свойство classList доступно только для чтения, но его можно изменять с помощью методов add() и remove().
Поддержка браузеров
Числа в таблице показывают первую версию браузера, которая полностью поддерживает это свойство.
| Свойство | |||||
|---|---|---|---|---|---|
| classList | 8.0 | 10.0 | 3.6 | 5.1 | 11.5 |
Синтаксис
Свойства
| Свойство | Описание |
|---|---|
| length | Возвращает количество классов в списке классов. Это свойство доступно только для чтения. |
Методы
| Метод | Описание |
|---|---|
| add(class1, class2, ...) | Добавляет одно или несколько имён классов к элементу. Если указанное имя класса уже существует, оно не будет добавлено. |
| contains(class) | Возвращает логическое значение, определяющее, существует ли указанное имя класса. Возможные значения:
|
| item(index) | Возвращает имя класса по указанному индексу в элементе. Индекс начинается с 0. Если индекс выходит за пределы диапазона, возвращается null.null |
| remove(class1, class2, ...) | Удаляет одно или несколько имён классов из элемента. Примечание:Удаление имени класса, которого не существует, не вызовет ошибку. |
| toggle(class, true|false) | Переключает имя класса у элемента. Первый параметр — это имя класса, которое нужно удалить из элемента, и возвращает false. Если имя класса не существует, оно будет добавлено к элементу, и возвращается true. Второй параметр необязателен — это логическое значение, используемое для принудительного указания, добавить или удалить класс у элемента, независимо от того, существует ли имя класса. Например: Удалить класс:element.classList.toggle("classToRemove", false); Добавить класс:element.classList.toggle("classToAdd", true); Примечание:Internet Explorer или Opera 12 и более ранние версии не поддерживают второй параметр. |
Технические детали
| Возвращаемое значение: | DOMTokenList, содержащий список имён классов элемента. |
|---|
Другие примеры
Пример
Добавить несколько классов к элементу <div>:
Попробуйте сами »
Пример
Удалить класс из элемента <div>:
Попробуйте сами »
Пример
Удалить несколько классов из элемента <div>:
Попробуйте сами »
Пример
Переключить класс у элемента <div>:
Попробуйте сами »
Пример
Получить имена классов элемента <div>:
var x = document.getElementById("myDIV").classList;
xРезультат:
Попробуйте сами »
Пример
Посмотреть, сколько имён классов имеет элемент <div>:
xРезультат:
Попробуйте сами »
Пример
Получить первое имя класса (индекс 0) элемента <div>:
xРезультат:
Попробуйте сами »
Пример
Проверить, имеет ли элемент класс "mystyle":
xРезультат:
Попробуйте сами »
Пример
Проверить, имеет ли элемент класс "mystyle"; если он есть, удалить другое имя класса:
if (x.classList.contains("mystyle")) {
x.classList.remove("anotherClass");
} else {
alert("Не удалось найти.");
}
Попробуйте сами »
Связанные статьи
Учебник CSS:CSS-селекторы
Справочник по CSS:CSS .classСелекторы
Справочник по HTML DOM:Свойство className в HTML DOM
Справочник по HTML DOM:Метод getElementsByClassName() в HTML DOM
Справочник по HTML DOM:объект HTML DOM Style
Другие расширения
Объект Element