Método next() do jQuery de iteração

Exemplo

Encontrar o próximo irmão subsequente de cada parágrafo, selecionando apenas os parágrafos com a classe "selected":

$("p").next(".selected").css("background", "yellow");

Experimente pessoalmente

Definição e uso

next() obtém o irmão subsequente de cada elemento da coleção de elementos correspondentes. Se fornecermos um seletor, retornamos o próximo irmão subsequente que correspondente ao seletor.

Sintaxe

.next(selector)
Parâmetro Descrição
selector Valor de string, contendo a expressão de seletor usada para combinar elementos.

Explicação detalhada

Se fornecermos um objeto jQuery que representa uma coleção de elementos DOM, o método .next() nos permite procurar o elemento irmão subsequente do elemento紧跟 no árvore DOM e construir um novo objeto jQuery com o elemento correspondente.

Este método aceita uma expressão de seletor opcional, do tipo que passo para a função $(). Se o elemento irmão subsequente correspondente ao seletor for encontrado, ele ficará no novo objeto jQuery construído; caso contrário, será excluído.

Pense na seguinte página com lista simples:

<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 pelo item três, podemos encontrar o elemento subsequente que surge:

$('li.third-item');.next();.css('background-color', 'red');

Experimente pessoalmente

O resultado dessa chamada é que o projeto 4 foi configurado com fundo vermelho. Como não aplicamos expressão de seletor, o elemento subsequente é claramente incluído como parte do objeto. Se já aplicamos um seletor, antes de incluí-lo, verificamos se há correspondência.