Método nextUntil() de navegação jQuery
Exemplo
Encontrar os irmãos seguintes seguidos de <dt id="term-2"> até o próximo <dt>, e configurá-los para ter fundo vermelho. Enquanto isso, encontrar os elementos <dd> irmãos seguintes seguidos de <dt id="term-1"> até <dt id="term-3">, e configurá-los para ter cor de texto azul.
$("#term-2").nextUntil("dt").css("background-color", "red");
var term3 = document.getElementById("term-3");
$("#term-1").nextUntil(term3, "dd").css("color", "blue");
Definição e uso
nextUntil() obtém todos os irmãos seguintes de cada elemento, mas não inclui os elementos correspondentes ao seletor, nó DOM ou objeto jQuery passado.
Sintaxe 1
.nextUntil(selector,filter)
| Parâmetro | Descrição |
|---|---|
| selector | Valor de string, contendo a expressão de seletor que indica onde parar a correspondência dos irmãos seguintes. |
| filter | Valor de string, contendo a expressão de seletor usada para correspondência de elementos. |
Sintaxe 2
.nextUntil(element,filter)
| Parâmetro | Descrição |
|---|---|
| element | Indica onde parar a correspondência dos irmãos seguintes do nó DOM ou do objeto jQuery. |
| filter | Valor de string, contendo a expressão de 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 .nextUntil() nos permite procurar pelos irmãos seguintes dos elementos na árvore DOM, parando a busca quando encontrar o elemento correspondente ao parâmetro do método. O novo objeto jQuery retornado contém todos os irmãos seguintes, mas não inclui o elemento correspondente ao parâmetro.
Se o seletor não correspondente ou não for especificado, ele selecionará todos os irmãos seguintes; se não for fornecido um seletor para filtrar, os elementos selecionados pelo método serão os mesmos que pelo .nextAll().
Para jQuery 1.6, nós podemos passar o nó DOM ou o objeto jQuery, em vez de um seletor, para o método .nextUntil().
Este método aceita uma expressão de seletor opcional como seu segundo parâmetro. Se este parâmetro for especificado, ele filtrará os elementos através da verificação de se eles correspondem ao seletor.
