Método prevUntil() da jQuery de navegação
Exemplo
Encontrar todos os elementos irmãos de cada elemento p que tenham a classe "selected":
$("p").siblings(".selected")
Definição e uso
siblings() obtém os irmãos de cada elemento da coleção correspondente, a filtragem por meio do seletor é opcional.
Sintaxe
.siblings(selector)
| Parâmetro | Descrição |
|---|---|
| selector | Valor de string, contendo a expressão do seletor usada para correspondência de elementos. |
Explicação detalhada
Se fornecermos um objeto jQuery que representa uma coleção de elementos DOM, o método .siblings() permite que busquemos os elementos irmãos desses elementos na árvore DOM e construamos um novo objeto jQuery com os elementos correspondentes.
Este método aceita uma expressão de seletor opcional, do tipo de parâmetro que passamos para a função $(). Se aplicarmos este seletor, faremos a filtragem dos elementos verificando se eles correspondem ao seletor.
Pense nessa página com uma lista aninhada básica:
<ul> <li>item da lista 1</li> <li>item da lista 2</li> <li class="third-item">item da lista 3</li> <li>item da lista 4</li> <li>item da lista 5</li> </ul>
Se começarmos a partir do terceiro item, podemos encontrar os elementos irmãos deste elemento:
$('li.third-item').siblings().css('background-color', 'red');
O resultado da chamada aqui é definir o fundo dos itens 1, 2, 4 e 5 como vermelho. Definir o fundo como vermelho. Como não aplicamos a expressão do seletor, todos os elementos irmãos naturalmente se tornaram parte do objeto. Se aplicarmos o seletor, apenas os itens que correspondem aos quatro listas serão incluídos.
O elemento original não inclui elementos irmãos, lembre-se de um ponto muito importante quando pretendemos encontrar todos os elementos em um nível específico da árvore DOM.
