jQuery метод .is()

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

jQuery метод .is() проверяет текущий соответствующий набор элементов относительно селектора, элемента, или объекта jQuery и возвращает логическое значение true, если хотя бы один из этих элементов соответствует приведенному значению.

До версии jQuery 1.7 такие позиционные селекторы как :first(), :gt(), или :even(), используемые в методе .is() для сопоставления с элементами, приводили к некорректному результату, так как сравнение происходило по коллекции jQuery, а не всему документу.

Не смотря на то, что начиная с версии jQuery 1.7 библиотека jQuery корректно работает с позиционными селекторами, разработчики библиотеки рекомендуют не использовать (когда это возможно) позиционные селекторы, они являются дополнением jQuery, а не стандартом W3C.

jQuery синтаксис:

Синтаксис 1.0:

JavaScript
$( selector ).is( selector )

Синтаксис 1.6:

Код
$( selector ).is( function )
$( selector ).is( selection )
$( selector ).is( elements )

selector - Selector

Код
function - ( Integer index, Element element )

selection - jQuery object

elements - DOM Element

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

1.0 (расширен в версии 1.6)

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

Параметр Описание
selector Строка, содержащая выражение селектор, который будет использоваться для сопоставления с элементами.
function(index, element) Функция, используемая в качестве проверки (сопоставления) каждого элемента в наборе. Функция принимает два аргумента:
  • index - индекс элемента в коллекции jQuery.
  • element - текущий элементу DOM.
selection Существующий объект jQuery, который будет использован для сопоставления с текущим набором элементов.
elements Один, или несколько элементов DOM, которые будет использованы для сопоставления с текущим набором элементов.

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

Пример использования jQuery метода .is()

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

index.html
HTML
<ul>
  <li>Первый</li>
  <li class="active">Второй</li>
  <li>Третий</li>
</ul>
main.js
JavaScript
$(document).ready(function () {
    $('li').click(function () {
        $(this).is('.active') ? $(this).css('color', 'green') : $(this).css('color', 'red')
    })
})

В этом примере с использованием jQuery метода .is() мы при нажатии на элемент <li> проверяем имеет ли данный элемент класс active, если да, то с помощью метода .css() устанавливаем цвет текста зеленый, если нет то красный.

В следующем примере мы рассмотрим использование метода .is() с функцией, переданной в качестве параметра:

Метод .is() — пример 2

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

index.html
HTML
<ul>
  <li>Первый</li>
  <li class="active">Второй</li>
  <li>Третий</li>
</ul>
main.js
JavaScript
$(document).ready(function () {
    $('li').is(function (index, elem) {
        // задаем функцию для проверки каждого элемента <li>
        // проверяем имеет ли конкретный элемент <li> класс active
        $(elem).is('.active') ? console.log(index + 'true') : console.log(index + 'false')
    })
})
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%;
}

В этом примере с использованием jQuery метода .is() и функции, переданной в качестве параметра мы проводим проверку каждого элемента <li> в документе. Обратите внимание, что внутри функции мы так же используем метод .is() для проврки конкретного элемента. Если элемент <li> имеет класс active, то мы выводим в консоль его индекс и строковое значение true, если нет, то его индекс и значение false.