HTML DOM Element closest() -menetelmä

määritelmä ja käyttö

closest() menetelmä etsii DOM-puusta elementtejä, jotka vastaavat määritettyä CSS-valitsinta.

closest() menetelmä alkaa elementistä itsestään ja siirtyy isäntäelementteihin (isoäiti, isoväri, ...), kunnes löydetään vastaava.

Jos vastaavaa ei löydy, niin closest() menetelmä palauttaa null.

katso myös:

Kattava CSS-valitsin -oppaasti

Element matches() -menetelmä

esimerkki

esimerkki 1

Löydä lähin elementti, joka vastaa CSS-valitsinta ".container":

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

kokeile itse

esimerkki 2

Löydä lähin elementti, joka vastaa ".container" tai ".wrapper":

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

kokeile itse

syntaksi

elementti.closest(valitsimet)

parametrit

parametrit kuvaus
valitsimet

pakollinen. Yksi tai useampi (pilkuin erotettu) valittava CSS-valitsin.

katso kattava CSS-valitsinreferenssikirja.

palautusarvo

tyyppi kuvaus
objekti

Lähin isäntäväri tai elementti itsessään, joka vastaa määritettyä CSS-valitsinta.

Jos yhdenkään vastaavan löytämättä, niin palautetaan null.

Jos valitsin on epäsyntynyt, niin aiheutetaan SYNTAX_ERR poikkeus.

selaimen tuki

ensimmäinen täysin tuettu closest() menetelmän selaimen versio

Chrome Edge Firefox Safari Opera
Chrome
41		 Edge
15		 Firefox
35		 Safari
9		 Opera
28
Vuosi 2015, kuukausi maaliskuu huhtikuu 2017 tammikuu 2015 lokakuu 2015 Vuosi 2015, kuukausi maaliskuu