HTML DOM Element closest() Methode

Definition und Verwendung

closest() Die Methode durchsucht das DOM-Baum für Elemente, die mit dem angegebenen CSS-Selector übereinstimmen.

closest() Die Methode beginnt beim Element selbst und dann bei den Vorfahren (Eltern, Urgroßeltern, ...), bis ein Übereinstimmungsfund erfolgt.

Wenn kein passender Eintrag gefunden wird, dann closest() Methode gibt zurück null.

Weitere Informationen siehe:

Vollständiges Referenzhandbuch für CSS-Selektoren

Element matches() Methode

Beispiel

Beispiel 1

Finden Sie das nächstgelegene Element, das mit dem CSS-Selector ".container" übereinstimmt:

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

亲自试一试

Beispiel 2

Finden Sie das nächstgelegene Element, das ".container" oder ".wrapper" entspricht:

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

亲自试一试

语法

element.closest(selectors)

参数

参数 Beschreibung
selectors

必需。一个或多个（逗号分隔的）要匹配的 CSS 选择器。

Bitte参阅我们的完整 CSS-Selektor-Referenzhandbuch.

Rückgabewert

Typ Beschreibung
Objekt

Der nächstgelegene Vorfahrelement oder das Element selbst, das mit dem angegebenen CSS-Selector übereinstimmt.

Wird kein passender Eintrag gefunden, wird null zurückgegeben.

Falls der Selector ungültig ist, wird eine SYNTAX_ERR-Ausnahme ausgelöst.

Browser-Unterstützung

ersten vollständig unterstützten closest() Browser-Version der Methode:

Chrome Edge Firefox Safari Opera
Chrome
41		 Edge
15		 Firefox
35		 Safari
9		 Opera
28
März 2015 April 2017 Januar 2015 Oktober 2015 März 2015