Gegeven aan een jQuery object dat een set DOM elementen representeert, zoekt de .prev() methode naar de voorganger van elk van deze elementen in de DOM tree en construeert een nieuw jQuery object uit de overeenkomende elementen.
De methode accepteert optioneel een selector expressie van hetzelfde type dat kan worden doorgegeven aan de $() functie. Als de selector wordt doorgegeven, wordt het voorgaande element gefilterd door te testen of het met de selector overeenkomt.
Bekijk een pagina met een eenvoudige lijst erop:
|
1
2
3
4
5
6
7
|
|
Om het element te selecteren dat direct voor item drie komt:
|
1
|
|
Het resultaat van deze oproep is een rode achtergrond achter item 2. Aangezien er geen selectoruitdrukking is meegegeven, wordt dit voorgaande element ondubbelzinnig opgenomen als onderdeel van het object. Als er een was meegegeven, zou het element worden getest op een overeenkomst voordat het werd opgenomen.
Als er geen voorgaande sibling bestaat, of als het voorgaande sibling-element niet overeenkomt met een meegegeven selector, wordt een leeg jQuery-object teruggegeven.
Om alle voorgaande sibling-elementen te selecteren, in plaats van alleen de voorgaande aangrenzende sibling, gebruikt u de methode .prevAll().