DOMTokenList: метод add()
Базовая Широко доступна
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.
Метод add() интерфейса DOMTokenList добавляет указанные токены в список, опуская те, которые уже присутствуют.
Синтаксис
add(token1) add(token1, token2) add(token1, token2, /* …, */ tokenN)
Параметры
tokenN-
Строка, представляющая токен (или токены), который(е) необходимо добавить в
DOMTokenList.
Возвращаемое значение
Ничего.
Исключения
-
SyntaxErrorDOMException -
Выбрасывается, если один из аргументов является пустой строкой
-
InvalidCharacterErrorDOMException -
Выбрасывается, если токен содержит 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