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

Kokeile itse

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.