jQuery метод .addClass()

Определение и применение

jQuery метод .addClass() добавляет один или несколько имен классов для выбранных элементов. Метод может быть также использован в документах XML и формате SVG.

jQuery синтаксис:

Синтаксис 1.0:

JavaScript
$(selector).addClass(className)

Синтаксис 1.4:

Код
$(selector).addClass(function(index, currentClassName ))

где:

index - Integer

currentClassName - String

Добавлен в версии jQuery

1.0 (синтаксис обновлен в версии 1.4)

Значения параметров

Параметр Описание
className Задает одно или несколько имен классов, которые будут добавлены к элементу, или элементам.
function(index, currentClassName) Задает функцию, которая возвращает одно или несколько имен классов, которые будут добавлены.
  • index - возвращает индекс позиции элемента в наборе (среди выбранных элементов).
  • currentClassName - возвращает текущее имя класса выбранного элемента.

Массив имён классов

С jQuery 3.3 метод .addClass() принимает также массив строк: .addClass(["active", "selected"]). Функция обратного вызова может возвращать такой массив вместо строки. Имена указываются без точки; каждый элемент массива — отдельный класс.

Пример использования

Добавление двух классов при клике

Нажмите ▶, затем выполните действие из пояснения. Измените JavaScript и запустите пример ещё раз. В редакторе используется jQuery 4.0.0.

index.html
HTML
<p>Обычный абзац</p>
<p>Обычный абзац</p>
<p>Обычный абзац</p>
<p>Обычный абзац</p>
main.js
JavaScript
$(document).ready(function () {
    $('p').click(function () {
        $(this).addClass('transition redColor')
    })
})
style.css
CSS
.redColor {
    color: red;
}
.transition {
    transition: 0.5s;
}

В этом примере с использованием jQuery метода .addClass() мы добавляем два класса к элементу <p> (абзац) по которому произведён клик.

Рассмотрим пример в котором в качестве параметра метода .addClass() передадим функцию:

Выбор нового класса по текущему классу абзаца

Нажмите ▶. Измените JavaScript и запустите пример повторно. Используется jQuery 4.0.0.

index.html
HTML
<p>Обычный абзац</p>
<p class="redColor">Обычный абзац</p>
<p class="redColor">Обычный абзац</p>
<p>Обычный абзац</p>
main.js
JavaScript
$(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
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
HTML
<p>Обычный абзац</p>
<p>Обычный абзац</p>
<p>Обычный абзац</p>
<p>Обычный абзац</p>
main.js
JavaScript
document.querySelectorAll('p').forEach((paragraph) => {
  paragraph.addEventListener('click', () => {
    paragraph.classList.add('transition', 'redColor');
  });
});
style.css
CSS
.redColor {
    color: red;
}
.transition {
    transition: 0.5s;
}

В classList.add() имена передают отдельными аргументами: строка с пробелами вызовет ошибку. Для массива используйте paragraph.classList.add(...names). Функцию, вычисляющую классы для каждого элемента, вызывайте самостоятельно внутри обхода.