English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

HTML DOM свойство classList

Объект элемента HTML DOM

classListЧтение属性 возвращает в реальном времени набор DOMTokenList, представляющий классовые атрибуты элемента.

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

Этот атрибут является только чтением, хотя вы можете изменить его с помощью методов add() и remove().

Использование classList - это удобный способ заменить метод, который позволяетclassNameДоступ к списку классов элемента через строку, разделенную пробелами.

Грамматика:

element.classList
var elem = document.getElementById("x");
elem.classList.add("para");
Проверьте, посмотрите‹/›

Совместимость браузеров

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

Свойство
classList83.6Да5.110

Свойство

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

Метод

МетодОписание
add(class1, class2, ...)Добавьте один или несколько классовых имен к элементу.
Если в свойстве class элемента уже существует указанный класс, то этот класс не будет добавлен.
contains(class)Проверьте, существует ли указанное значение класса в свойстве class элемента.
Возможные значения:
  • true-Элемент содержит указанное имя класса

  • false-Элемент не содержит указанного класса

item(index)Возвращает значение класса по индексу в наборе. Индекс начинается с 0.
Если индекс выходит за пределы диапазона, то возвращаетсяnull.
remove(class1, class2, ...)Удалите один или несколько классовых имен из элемента.
Внимание:Удаление несуществующего класса не вызовет ошибку.
replace(oldClass, newClass)Заменить существующие классы новыми.
toggle(class, true|false)Переключать значения классов между элементами.
При наличии только одного параметра: переключить значение класса; в противном случае, вернуть 0. То есть, если класс существует, удалить его и вернуть false, если класс не существует, добавить его и вернуть true.
При наличии второго опционального параметра: если значение второго параметра равно true, добавить указанный класс; если значение второго параметра равно false, удалить его.
Пример:
          Удалить класс:element .classList.toggle("classToRemove", false);
  Добавить класс:element .classList.toggle("classToAdd", true);

Технические детали

Возвратное значение:DOMTokenList, содержащий список классов элемента
Версия DOM:Уровень DOM 1

Более примеров

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

var elem = document.getElementById("x");
elem.classList.add("para", "shadow");
Проверьте, посмотрите‹/›

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

var elem = document.getElementById("x");
elem.classList.remove("para");
Проверьте, посмотрите‹/›

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

var elem = document.getElementById("x");
elem.classList.remove("para", "shadow");
Проверьте, посмотрите‹/›

Переключить класс <p> элемента между двумя классами:

var elem = document.getElementById("x");
elem.classList.toggle("anotherClass");
Проверьте, посмотрите‹/›

Вернуть классы, имеющиеся у <p> элемента:

var len = document.getElementById("x").classList.length;
Проверьте, посмотрите‹/›

Вернуть классы <p> элемента:

var name = document.getElementById("x").classList;
Проверьте, посмотрите‹/›

Вернуть первый класс <p> элемента (индекс 0):

var name = document.getElementById("x").classList[0];
Проверьте, посмотрите‹/›

Использовать метод item() для получения первого класса <p> элемента (индекс 0):

var name = document.getElementById("x").classList.item(0);
Проверьте, посмотрите‹/›

Найти элемент, имеющий класс "shadow":

var list = document.getElementById("x").classList;
if (list.contains("shadow")) {}}
alert("Yes!!! The P element contains 'shadow' class");
}
alert("No 'shadow' class found");   
}
Проверьте, посмотрите‹/›

Переключить класс ("open") для создания боковой навигационной кнопки:

Связанные руководства

Учебник CSS:CSS selector

CSS Reference:CSS#idВыборщик

CSS Reference: CSS .class Выборщик

Референс по HTML DOM:Свойство className HTML DOM

Референс по HTML DOM:Метод getElementsByClassName() HTML DOM

Референс по HTML DOM:Метод getElementById() HTML DOM

Референс по HTML DOM:Метод querySelector() HTML DOM

Объект элемента HTML DOM