CKTIS / JavaScript
Element.closest — najbližší zodpovedajúci predok
Element.closest(selectors) skontroluje daný element a potom jeho predkov. Vráti prvý element zodpovedajúci CSS selektoru alebo null.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.closest(selectors)Element.closest(selectors) je metóda DOM, nie samotného ECMAScriptu. Najprv skontroluje element, na ktorom sa zavolá, potom jeho rodiča a ďalších predkov. Vráti najbližší zodpovedajúci Element alebo null.
Argument selectors je reťazec s CSS selektorom. Neplatná syntax vyvolá DOMException s názvom SyntaxError, namiesto toho, aby metóda vrátila null. Metóda nevyhľadáva medzi potomkami ani neprechádza z tieňového stromu k jeho hostiteľovi.
Príklad kontroluje najbližšieho zodpovedajúceho predka, zhodu samotného elementu a prípad bez zhody. Strom nemusí byť pripojený k dokumentu.
Príklady
const outer = document.createElement('section');
const inner = document.createElement('div');
const button = document.createElement('button');
outer.className = 'panel';
inner.className = 'panel';
outer.append(inner);
inner.append(button);
console.log(button.closest('.panel') === inner);
console.log(button.closest('button') === button);
console.log(button.closest('.missing'));Výsledok
true true null
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.