Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Element.closest — najbližji ustrezni prednik

Element.closest(selectors) preveri element in nato njegove prednike. Vrne prvi element, ki ustreza izbirniku CSS, ali null.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

element.closest(selectors)

Element.closest(selectors) je metoda DOM-a, ne pa samega ECMAScripta. Najprej preveri element, na katerem je bila poklicana, nato njegovega starša in naslednje prednike. Vrne najbližji ustrezni Element ali null.

Argument selectors je niz z izbirnikom CSS. Neveljavna sintaksa sproži DOMException z imenom SyntaxError, namesto da bi metoda vrnila null. Metoda ne išče med potomci in ne preide iz senčnega drevesa do njegovega gostitelja.

Primer preveri najbližjega ustreznega prednika, ujemanje samega elementa in primer brez ujemanja. Drevesa ni treba pripeti dokumentu.

Primeri

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'));

Rezultat

true
true
null

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri