jQuery-selauksen - prevUntil() -menetelmä
Esimerkki
Etsi <dt id="term-2"> edelliset sisar-elementit, kunnes kohdetaan edellinen <dt>, ja aseta ne punaiseksi. Samalla etsi <dt id="term-3"> edellinen <dd> -sisar-elementti, kunnes kohdetaan <dt id="term-1">, ja aseta ne siniseksi tekstinä:
$("#term-2").prevUntil("dt").css("background-color", "red"); var term1 = document.getElementById('term-1'); $("#term-3").prevUntil(term1, "dd").css("color", "green");
Määritelmä ja käyttö
prevUntil() -menetelmä hakee jokaisen nykyisen matchaustuloksen edellisen sisar-elementin, mutta ei elementtiä, jota valitsija, DOM-elementti tai jQuery-objekti matchaa.
Syntaksi 1
.prevUntil(selector, filter)
Parametrit | Kuvaus |
---|---|
selector | Valinnainen. Merkkijonoarvo, joka sisältää valitsijalausekkeen, jota käytetään edellisten sisar-elementtien matchaamisen lopettamiseen. |
filter | Valinnainen. Merkkijonoarvo, joka sisältää valitsijalausekkeen, jota käytetään elementtien matchaamiseen. |
Syntaksi 2
.prevUntil(element, filter)
Parametrit | Kuvaus |
---|---|
element | Valinnainen. Indikoi, missä kohdassa matchaaminen edellisiä sisar-elementtejä lopetetaan DOM-elementti tai jQuery-objekti. |
filter | Valinnainen. Merkkijonoarvo, joka sisältää valitsijalausekkeen, jota käytetään elementtien matchaamiseen. |
Yksityiskohtainen selitys
Jos annetaan jQuery-objekti, joka edustaa DOM-elementtien joukkoa, .prevUntil() -menetelmä mahdollistaa etsinnän näiden elementtien edellisiä sisar-elementtejä DOM-puussa, kunnes kohdetaan valitsijaa (menetelmään annettu parametri) vastaava elementti. Palautettu uusi jQuery-objekti sisältää kaikki edelliset sisar-elementit, mutta ei valitsijaa .prevUntil() -menetelmällä määriteltyä elementtiä; palautettujen elementtien järjestys on lähimmästä sisar-elementistä kauimmaiseen.
Jos elementit eivät vastaa valitsijaa tai valitsinta ei ole sovellettu, valitaan kaikki edelliset sisar-elementit; tällöin menetelmä valitsee samat elementit kuin .prevAll() ilman valitsinta.
jQuery 1.6:ssa DOM-elementti tai jQuery-objekti voidaan käyttää .prevUntil() -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.