Метод closest() элемента HTML DOM

Определение и использование

closest() Метод ищет элементы в DOM-дереве, соответствующие заданному CSS-селектору.

closest() Метод начинается с элемента本身 и затем идет по предкам (родитель, дед, ...), до тех пор, пока не найден соответствующий элемент.

Если не найден соответствующий элемент, то closest() Метод возвращает null.

Дополнительная информация:

Полный справочник по CSS-селекторам

Метод Element matches()

Пример

Пример 1

Найти ближайший элемент, соответствующий CSS-селектору ".container":

const element = document.getElementById("myElement");
const closest = element.closest(".container");

Попробуйте сами

Пример 2

Найти ближайший элемент, соответствующий ".container" или ".wrapper":

const element = document.getElementById(".container, .wrapper");
const closest = element.closest(".container");

Попробуйте сами

Грамматика

element.closest(selectors)

Параметр

Параметр Описание
selectors

Обязателен. Один или несколько (разделенных запятыми) CSS-селекторов, которые необходимо соответствовать.

Пожалуйста, обратитесь к нашему полному Референсный справочник CSS селекторов.

Возвратное значение

Тип Описание
Объект

Ближайший элемент-предок или элемент сам по себе, соответствующий заданному CSS-селектору.

Если не найден соответствующий элемент, возвращает null.

Если селектор недействителен, вызывается исключение SYNTAX_ERR.

браузер поддержка

первый полностью поддерживающий closest() Версия браузера метода:

Chrome Edge Firefox Safari Opera
Chrome
41		 Edge
15		 Firefox
35		 Safari
9		 Opera
28
Март 2015 года 2017 год 4 апреля 2015 год 1 января 2015 год 10 октября Март 2015 года