Содержание:
.closest( selector )Возвращает: jQuery
Описание: Для каждого элемента в наборе, получает первый элемент, который совпадает с селектором при движении вверху по DOM дереву элементов.
-
Добавлен в версии 1.3.closest( selector )
-
selectorТип: SelectorСтрока содержащая выражение селектора для проверки совпадения элементов.
-
-
Добавлен в версии 1.4.closest( selector [, context ] )
-
Добавлен в версии 1.6.closest( selection )
-
selectionТип: jQueryОбъект jQuery для проверки совпадения элементов.
-
-
Добавлен в версии 1.6.closest( element )
-
elementТип: ElementЭлемент для проверки совпадения элементов.
-
Учитывая, что объект jQuery представляет из себя набор DOM элементов, метод .closest()
находит потомков и создает новый jQuery объект из найденных элементов. Методы .parents()
и .closest()
аналогичны, тем что делают обход элементов вверху по DOM дереву. Различия между ними весьма тонкие, но имеют важное значение:
.closest()
|
.parents()
|
---|---|
Начинает обход с текущего элемента | Начинает обход с родительского элемента |
Делает обход вверх по DOM дереву, до тех пор пок не найдет совпадения для заданного селектора | Делает обход вверх по DOM дереву, до самого верхнего элемента документа, добавляя каждый найденный элемент во временную коллекцию; затем результат фильтруется при помощи селектора если он указан |
Результат выполнения - объект jQuery, содержащий ноль или один элемент для каждого элемента в изначальном наборе элементов object, в прямом порядке документа | Результат выполнения - объект jQuery, содержащий ноль или больше элементов для каждого элемента в изначальном наборе элементов, в обратном порядке документа |
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
|
Предположим мы проводим поиск элементов <ul>
начиная с элемента A:
1
2
3
|
|
Это изменит цвет элемента <ul>
с классом level-2, так как он первым столкнется при движении вверх по DOM дереву.
Предположим мы ищем элемент <li>
:
1
2
3
|
|
Это изменит цвет элемента списка A. Метод .closest()
наинает поиск с элемента для которого вызван перед процессом движения вверх по DOM дереву и останавливается когда элемент списка A соответствует селектору.
Мы можем передать DOM элемент как контекст при помощи которого будет искаться ближайший элемент.
1
2
3
4
5
6
7
|
|
Это изменит цвет элемента <ul>
с классом level-2, потому как первый <ul>
предок элемента списка и потомок элемента списка II. Это не изменит цвет элемента <ul>
с классом level-1, поскольку он не является потомком элемента списка II.
.closest( selectors [, context ] )Возвращает: ArrayУстарел в версии: 1.7, Удален в версии: 1.8
Описание: Для каждого элемента в наборе, получает первый элемент, который совпадает с селектором при движении вверху по DOM дереву элементов.
-
Добавлен в версии 1.4.closest( selectors [, context ] )