HTML DOM classListСвойство

元素对象参考手册Объект Element

Примеры

Добавьте класс к элементу <div>:

document.getElementById("myDIV").classList.add("mystyle");

Попробуйте сами »

Определение и использование

Свойство classList возвращает имя (имена) класса элемента в виде объекта DOMTokenList.

Это свойство используется для добавления, удаления и переключения CSS-классов у элемента.

Свойство classList доступно только для чтения, но его можно изменять с помощью методов add() и remove().


Поддержка браузеров

Числа в таблице показывают первую версию браузера, которая полностью поддерживает это свойство.

Свойство
classList 8.0 10.0 3.6 5.1 11.5

Синтаксис

element.classList

Свойства

Свойство Описание
length Возвращает количество классов в списке классов.

Это свойство доступно только для чтения.

Методы

Метод Описание
add(class1, class2, ...) Добавляет одно или несколько имён классов к элементу.

Если указанное имя класса уже существует, оно не будет добавлено.
contains(class) Возвращает логическое значение, определяющее, существует ли указанное имя класса.

Возможные значения:

  • true — элемент уже содержит имя класса.
  • false — имя класса отсутствует в элементе.
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>:

document.getElementById("myDIV").classList.add("mystyle", "anotherClass", "thirdClass");

Попробуйте сами »

Пример

Удалить класс из элемента <div>:

document.getElementById("myDIV").classList.remove("mystyle");

Попробуйте сами »

Пример

Удалить несколько классов из элемента <div>:

document.getElementById("myDIV").classList.remove("mystyle", "anotherClass", "thirdClass");

Попробуйте сами »

Пример

Переключить класс у элемента <div>:

document.getElementById("myDIV").classList.toggle("newClassName");

Попробуйте сами »

Пример

Получить имена классов элемента <div>:

<div id="myDIV" class="mystyle anotherClass thirdClass">Я — элемент DIV</div>

var x = document.getElementById("myDIV").classList;

xРезультат:

mystyle anotherClass thirdClass

Попробуйте сами »

Пример

Посмотреть, сколько имён классов имеет элемент <div>:

var x = document.getElementById("myDIV").classList.length;

xРезультат:

3

Попробуйте сами »

Пример

Получить первое имя класса (индекс 0) элемента <div>:

var x = document.getElementById("myDIV").classList.item(0);

xРезультат:

mystyle

Попробуйте сами »

Пример

Проверить, имеет ли элемент класс "mystyle":

var x = document.getElementById("myDIV").classList.contains("mystyle");

xРезультат:

истина

Попробуйте сами »

Пример

Проверить, имеет ли элемент класс "mystyle"; если он есть, удалить другое имя класса:

var x = document.getElementById("myDIV");

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

Другие расширения