Givet et jQuery-objekt, der repræsenterer et sæt DOM-elementer, søger .prev()-metoden efter forgængeren for hvert af disse elementer i DOM-træet og konstruerer et nyt jQuery-objekt ud fra de matchende elementer.
Metoden accepterer valgfrit et selektorudtryk af samme type, som kan overføres til $()-funktionen. Hvis selektoren er leveret, filtreres det foregående element ved at teste, om det matcher selektoren.
Tænk på en side med en simpel liste på den:
|
1
2
3
4
5
6
6
7
|
|
For at vælge det element, der kommer umiddelbart før element tre:
|
1
|
|
Resultatet af dette kald er en rød baggrund bag element 2. Da der ikke er angivet noget selektorudtryk, er dette foregående element utvetydigt inkluderet som en del af objektet. Hvis der var blevet leveret et, ville elementet blive testet for et match, før det blev inkluderet.
Hvis der ikke findes noget foregående søskendeelement, eller hvis det foregående søskendeelement ikke matcher en leveret selector, returneres et tomt jQuery-objekt.
For at vælge alle foregående søskendeelementer i stedet for kun det foregående tilstødende søskendeelement skal du bruge .prevAll()-metoden.