Dado um objecto jQuery que representa um conjunto de elementos DOM, o método .prev()
procura o antecessor de cada um destes elementos na árvore DOM e constrói um novo objecto jQuery a partir dos elementos correspondentes.
O método aceita opcionalmente uma expressão selectora do mesmo tipo que pode ser passada para a função $()
. Se o seletor for fornecido, o elemento anterior será filtrado testando se ele corresponde ao seletor.
Consulte uma página com uma lista simples nela:
1
2
3
4
>5
6
7
|
> |
>
Selecionar o elemento que vem imediatamente antes do item três:
>1
|
> |
O resultado desta chamada é um fundo vermelho atrás do item 2. Uma vez que nenhuma expressão selectora é fornecida, este elemento precedente é inequivocamente incluído como parte do objecto. Se um tivesse sido fornecido, o elemento seria testado para uma correspondência antes de ser incluído.
Se não existir um irmão anterior, ou se o elemento irmão anterior não corresponder a um selector fornecido, é devolvido um objecto jQuery vazio.
Para seleccionar todos os elementos irmãos anteriores, em vez de apenas o irmão anterior adjacente, utilize o método .prevAll().