Spec-Zone.ru › Web APIs

DOMTokenList: метод add()

Базовая Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

Метод add() интерфейса DOMTokenList добавляет указанные токены в список, опуская те, которые уже присутствуют.

Синтаксис

add(token1)
add(token1, token2)
add(token1, token2, /* …, */ tokenN)

Параметры

tokenN

Строка, представляющая токен (или токены), который(е) необходимо добавить в DOMTokenList.

Возвращаемое значение

Ничего.

Исключения

SyntaxError DOMException

Выбрасывается, если один из аргументов является пустой строкой

InvalidCharacterError DOMException

Выбрасывается, если токен содержит ASCII-пробелы.

Примеры

В следующем примере мы получаем список классов, установленных на элементе <span>, как DOMTokenList, используя Element.classList. Затем мы добавляем новый токен в список и записываем список в Node.textContent элемента <span>.

Сначала HTML:

<span class="a b c"></span>

Теперь JavaScript:

const span = document.querySelector("span");
const classes = span.classList;
classes.add("d");
span.textContent = classes;

Вывод выглядит так:

Вы также можете добавить несколько токенов:

span.classList.add("d", "e", "f");

Спецификации

Спецификация
DOM
# ref-for-dom-domtokenlist-add①

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
add 8 12 3.6 ≤12.1 5.1 18 4 ≤12.1 5 1.0 3
multiple_parameters 24 12 26 15 7 25 26 14 7 1.5 4.4

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/DOMTokenList/add

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API