jQuery-selailu - parentsUntil() -menetelmä

Esimerkki

Etsi <li class="item-a">n esi-isäelementit, kunnes <ul class="level-1">, ja aseta niiden taustaväri punaiseksi. Etsi myös <li class="item-2">n kaikki "yes"-nimiset esi-isäelementit, kunnes <ul class="level-1">, ja aseta niiden reunaväri siniseksi:

$("li.item-a");.parentsUntil(".level-1");
  .css("background-color", "red");
$("li.item-2");.parentsUntil($("ul.level-1"), ".yes");
  .css("border", "3px solid blue");

Kokeile itse

Määritelmä ja käyttö

parentsUntil() hakee jokaisen nykyisen vastaavan elementin esi-isäelementit, kunnes kohdeelementti, joka vastaa valitsinta, DOM-elementtiä tai jQuery-objektia, löydetään (ei sisällä valitsijaa, DOM-elementtiä tai jQuery-objektia).

Syntaksi 1

.parentsUntil(selector,filter)
Parametrit Kuvaus
selector Valinnainen. Merkkijonovaranto, joka määrittää, missä kohdassa esi-isäelementtien vastaavuus lopetetaan.
filter Valinnainen. Merkkijonovaranto, joka sisältää valitsijalausekkeen, jota käytetään elementtien vastaavuuden tarkistamiseen.

Syntaksi 2

.parentsUntil(element,filter)
Parametrit Kuvaus
element Valinnainen. DOM-elementti tai jQuery-objekti, joka määrittää, missä kohdassa suodatus lopetetaan.
filter Valinnainen. Merkkijonovaranto, joka sisältää valitsijalausekkeen, jota käytetään elementtien vastaavuuden tarkistamiseen.

Yksityiskohtainen selitys

Jos annetaan jQuery-objekti, joka edustaa DOM-elementtien joukkoa, .parentsUntil() -menetelmä mahdollistaa etsinnän näiden elementtien esi-isäelementeistä DOM-puussa, kunnes kohdeelementti, joka vastaa valitsinta (annettu menetelmään parametrina), löydetään. Palautettu jQuery-objekti sisältää kaikki esi-isäelementit, mutta ei sitä elementtiä, johon .parentsUntil() -menetelmä määrittää valitsijan.

Jos elementit eivät vastaa valitsijaa tai valitsin ei ole sovellettu, valitaan kaikki esi-isäelementit; tällöin menetelmä valitsee samat elementit kuin .parents() ilman valitsinta.

jQuery 1.6:ssa DOM-elementti tai jQuery-objekti voidaan käyttää .parentsUntil() -menetelmän ensimmäisenä parametrina valitsijan sijaan.

Tämä menetelmä hyväksyy valinnaisen valitsinlausekkeen toisena parametrina. Jos tämä parametri sovelletaan, elementtejä suodellaan tarkistamalla, vastaavatko ne valitsijaa.