jQuery метод .addClass()
Определение и применение
jQuery метод .addClass() добавляет один или несколько имен классов для выбранных элементов. Метод может быть также использован в документах XML и формате SVG.
jQuery синтаксис:
Синтаксис 1.0:
$(selector).addClass(className)Синтаксис 1.4:
$(selector).addClass(function(index, currentClassName ))где:
index - Integer
currentClassName - String
Добавлен в версии jQuery
1.0 (синтаксис обновлен в версии 1.4)Значения параметров
| Параметр | Описание |
|---|---|
| className | Задает одно или несколько имен классов, которые будут добавлены к элементу, или элементам. |
function(index, currentClassName) |
Задает функцию, которая возвращает одно или несколько имен классов, которые будут добавлены.
|
Массив имён классов
С jQuery 3.3 метод .addClass() принимает также массив строк:
.addClass(["active", "selected"]). Функция обратного вызова может возвращать такой массив вместо строки.
Имена указываются без точки; каждый элемент массива — отдельный класс.
Пример использования
Добавление двух классов при клике
Нажмите , затем выполните действие из пояснения. Измените JavaScript и запустите пример ещё раз. В редакторе используется jQuery 4.0.0.
index.html
<p>Обычный абзац</p>
<p>Обычный абзац</p>
<p>Обычный абзац</p>
<p>Обычный абзац</p>
main.js
$(document).ready(function () {
$('p').click(function () {
$(this).addClass('transition redColor')
})
})
style.css
.redColor {
color: red;
}
.transition {
transition: 0.5s;
}
Нажмите , чтобы запустить пример.
В этом примере с использованием jQuery метода .addClass() мы добавляем два класса к элементу
<p>
(абзац) по которому произведён клик.
Рассмотрим пример в котором в качестве параметра метода .addClass() передадим функцию:
Выбор нового класса по текущему классу абзаца
Нажмите . Измените JavaScript и запустите пример повторно. Используется jQuery 4.0.0.
index.html
<p>Обычный абзац</p>
<p class="redColor">Обычный абзац</p>
<p class="redColor">Обычный абзац</p>
<p>Обычный абзац</p>
main.js
$(document).ready(function () {
$('p').addClass(function (index, currentClass) {
// задаем функцию в качестве параметра метода .addClass()
var addedClass // создаем переменную
if (currentClass === 'redColor') {
// если класс элемента идентичен redColor
addedClass = 'greenColor' // присваиваем значение переменной (соответствует значению класса)
$('div').append('<p>нашёлся с индексом - ' + index + '</p>') // добавляем в элемент <div> информацию о индексе элементов, которые были выбраны
}
return addedClass // возвращаем значение (значение переменной устанавливается в качестве класса элемента)
})
})
style.css
body {
margin: 16px;
font:
16px/1.5 system-ui,
sans-serif;
overflow-wrap: anywhere;
}
img,
input,
select,
textarea,
button {
max-width: 100%;
}
.redColor {
color: red; /* цвет текста красный */
}
.greenColor {
color: green; /* цвет текста зеленый */
}
div {
color: blue; /* цвет текста синий */
}
Нажмите , чтобы запустить пример.
В этом примере с использованием jQuery метода .addClass() мы нашли все элементы
<p>
(абзац), которые имеют класс "redColor", добавили для этих элементов класс "greenColor" и с
использованием метода .append() добавили в элемент
<div>
информацию о индексе элементов, которые были выбраны.
Как сделать на чистом JavaScript
Свойство classList позволяет менять классы одного элемента. Чтобы повторить основной пример, найдём все абзацы и добавим обработчик каждому из них. Нажмите , затем щёлкните по абзацу: он получит классы transition и redColor, как в примере jQuery. Измените имена классов и сравните результат.
index.html
<p>Обычный абзац</p>
<p>Обычный абзац</p>
<p>Обычный абзац</p>
<p>Обычный абзац</p>
main.js
document.querySelectorAll('p').forEach((paragraph) => {
paragraph.addEventListener('click', () => {
paragraph.classList.add('transition', 'redColor');
});
});
style.css
.redColor {
color: red;
}
.transition {
transition: 0.5s;
}
Нажмите , чтобы запустить пример.
В classList.add() имена передают отдельными аргументами: строка с пробелами вызовет ошибку. Для
массива используйте paragraph.classList.add(...names). Функцию, вычисляющую классы для каждого
элемента, вызывайте самостоятельно внутри обхода.