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");
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.