jQuery - Методы для работы с набором элементов

Статья, в которой рассматриваются различные методы библиотеки jQuery, предназначенные для фильтрации элементов текущего набора, для поиска в DOM-дереве других элементов, связанных с элементами текущего набора некоторым отношением, и для выполнения других операций.

Виды методов jQuery для работы с набором элементов

Библиотека jQuery содержит методы, которые предназначены для выполнения различных операций над набором элементов. Эти методы сгруппированы в 3 категории:

• Методы для фильтрации элементов текущего набора: eq(), first(), last(), slice(), filter(), has(), is(), map(), not().
• Методы, осуществляющие поиск элементов в DOM-дереве: children(), closest(), find(), next(), nextAll(), nextUntil(), offsetParent(), parent(), parents(), parentsUntil(), prev(), prevAll(), prevUntil(), siblings().
• Категория, в которой собраны методы, выполняющие различные действия: add(), addBack(), contents(), end(), not().

Методы для фильтрации элементов текущего набора

В данной категории собраны методы jQuery, которые предназначены для фильтрации элементов текущего набора.

.eq(index) - осуществляет выбор элемента с указанным индексом (index) из текущей выборки.

.first() - осуществляет выбор первого элемента из текущей выборки.

.last() - осуществляет выбор последнего элемента из текущей выборки.

.slice(startIndex[,endIndex]) - осуществляет выбор из текущего набора только тех DOM-элементов, которые имеют индексы в пределах указанного диапазона (от startIndex до endIndex).

.filter(выражение) - осуществляет выбор элементов из текущего набора в соответствии с указанным выражением (selector).

.has(selector) - осуществляет выбор только тех элементов из текущей выборки, которые имеют хотя бы один из элементов, заданных с помощью селектора (или в виде DOM-коллекции), в качестве своего потомка.

.map(функция) - возвращает объект jQuery, состоящий из результатов, которая возвратила указанная в качестве параметра функция для каждого элемента текущего набора.

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

.not(выражение) - осуществляет выбор из текущего набора только тех элементов, которые не соответствуют выражению, указанному в качестве параметра данного метода.

Методы, осуществляющие поиск элементов в DOM-дереве

В этой категории собраны методы jQuery, которые для каждого элемента текущего набора осуществляют поиск других элементов в DOM-дереве на основе того, каким они отношением связаны с исходным.

.next(). Данный метод выполняет следующее: он для каждого элемента текущего набора осуществляет поиск следующего за ним элемента, который должен являться по отношению к нему сиблингом (siblings). Метод .next() в качестве своего результата - возвращает объект jQuery, состоящий из найденных элементов.

.nextAll() - Данный метод выполняет следующее: он для каждого элемента текущего набора осуществляет поиск всех следующих за ним элементов, которые по отношению к нему являются сиблингами (siblings). Метод .nextAll() в качестве своего результата - возвращает объект jQuery, состоящий из найденных элементов.

.nextUntil([селектор|элемент]) - Данный метод выполняет следующее: он для каждого элемента текущего набора осуществляет поиск всех следующих за ним элементов (являющиеся по отношению к нему сиблингом) до указанного. Метод .nextUntil() в качестве своего результата - возвращает объект jQuery, состоящий из найденных элементов.

.prev() - Данный метод выполняет следующее: он для каждого элемента текущего набора осуществляет поиск предыдущего элемента, который является по отношению к нему сиблингом (siblings). Метод .prev() в качестве своего результата - возвращает объект jQuery, состоящий из найденных элементов.

.prevAll() - Данный метод выполняет следующее: он для каждого элемента текущего набора осуществляет поиск всех предыдущих элементов, которые являются по отношению к нему сиблингом (siblings). Метод .prevAll() в качестве своего результата - возвращает объект jQuery, состоящий из найденных элементов.

.prevUntil(селектор|элемент) - Данный метод выполняет следующее: он для каждого элемента текущего набора осуществляет поиск всех предыдущих элементов (являющие по отношение к нему сиблингом) до указанного. Метод .prevUntil() в качестве своего результата - возвращает объект jQuery, состоящий из найденных элементов.

.sibling() - Данный метод выполняет следующее: он для каждого элемента текущего набора осуществляет поиск всех элементов в DOM-дереве, которые приходятся ему сиблингами (siblings). Метод .sibling() в качестве своего результата - возвращает объект jQuery, состоящий из найденных элементов.

.children() - Данный метод выполняет следующее: для каждого элемента текущего набора находит все элементы в DOM-дереве, которые приходятся ему детьми (child). Метод .children() в качестве своего результата - возвращает объект jQuery, состоящий из найденных элементов.

.closest(выражение) - Данный метод выполняет следующее: он для каждого элемента текущего набора осуществляет поиск элемента в DOM-дереве, который отвечает указанному в качестве параметра выражению. Поиск элементов данный метод осуществляет начиная с исходного элемента, далее переходит к родителю, потом к родителю родителя и т.д. вверх по DOM-дереву. Метод .closest() в качестве своего результата - возвращает объект jQuery, состоящий из найденных элементов.

.find() - Данный метод выполняет следующее: он для каждого элемента текущего набора осуществляет поиск всех элементов в DOM-дереве, которые приходятся ему потомками (включая детей). Метод .find() в качестве своего результата - возвращает объект jQuery, состоящий из найденных элементов.

.offsetParent() - Данный метод выполняет следующее: он для каждого элемента текущего набора осуществляет поиск его ближайшего элемента-предка, который не расположен в нормальном потоке (т.е. имеет CSS свойство position со значением relative, absolute или fixed). Метод .offsetParent() в качестве своего результата - возвращает объект jQuery, состоящий из найденных элементов.

.parent() - Данный метод выполняет следующее: он для каждого элемента текущего набора осуществляет поиск его родительского элемента в DOM-дереве. Метод .parent() в качестве своего результата - возвращает объект jQuery, состоящий из найденных элементов.

.parents() - Данный метод выполняет следующее: он для каждого элемента текущего набора осуществляет поиск всех элементов в DOM-дереве, которые приходятся ему предками (включая родителя). Метод .parents() в качестве своего результата - возвращает объект jQuery, состоящий из найденных элементов.

.parentsUntil(селектор|элемент) - Данный метод выполняет следующее: он для каждого элемента текущего набора осуществляет поиск всех его предков (включая родителя) до указанного. Метод .parentsUntil() в качестве своего результата - возвращает объект jQuery, состоящий из найденных элементов.

Методы, выполняющие различные действия, которые связаны с набором элементов

Кроме этого библиотека jQuery содержит дополнительные методы, которые собраны в категории "Разные" и предназначенные для выполнения различных действий, которые можно отнести к операциям, связанными с наборами элементов.

.add(выражение) - добавить к текущему набору дополнительные элементы, которые заданы с помощью выражения, указанного в качестве параметра данного метода.

.addBack() - добавить из стека цепочки методов jQuery предыдущий набор элементов в текущий набор. Данный параметр предоставляет возможность отфильтровать элементы предыдущего набора, перед тем как их добавить к текущему набору.

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

.end() - позволяет вернуться к набору элементов, которые были у предыдущей операции фильтрации в пределах текущей цепочки методов jQuery.

.not(выражение) - осуществляет выбор из текущего набора только тех элементов, которые не соответствуют выражению, указанному в качестве параметра данного метода.