Método prevUntil() de navegação jQuery
Exemplo
Encontre os elementos irmãos anteriores de <dt id="term-2"> até o <dt> anterior, e defina-os como vermelho. Ao mesmo tempo, encontre os elementos irmãos anteriores <dd> de <dt id="term-3"> até <dt id="term-1">, e defina o texto como azul:
$("#term-2").prevUntil("dt").css("background-color", "red");
var term1 = document.getElementById('term-1');
$("#term-3").prevUntil(term1, "dd").css("color", "green");
Definição e uso
O método prevUntil() obtém os elementos irmãos anteriores de cada elemento na coleção de elementos correspondentes, mas não inclui os elementos correspondentes ao seletor, nó DOM ou objeto jQuery.
Sintaxe 1
.prevUntil(selector, filter)
| Parâmetros | Descrição |
|---|---|
| selector | Opcional. Valor de string, contendo a expressão de seletor que indica onde a correspondência dos irmãos anteriores deve parar. |
| filter | Opcional. Valor de string, contendo a expressão de seletor usada para correspondência de elementos. |
Sintaxe 2
.prevUntil(element, filter)
| Parâmetros | Descrição |
|---|---|
| element | Opcional. Indica o nó DOM ou o objeto jQuery onde a correspondência dos irmãos anteriores deve parar. |
| filter | Opcional. Valor de string, contendo a expressão de seletor usada para correspondência de elementos. |
Explicação detalhada
Se for fornecido um objeto jQuery representando uma coleção de elementos DOM, o método .prevUntil() permite que busquemos os elementos irmãos anteriores desses elementos no árvore DOM até encontrar um elemento que correspondente ao seletor (passado como parâmetro para o método). O novo objeto jQuery retornado contém todos os elementos irmãos anteriores, mas não inclui o elemento correspondente ao seletor especificado pelo método .prevUntil(); a ordem dos elementos retornados é da mais próximo ao mais distante.
Se não houver correspondência ou se o seletor não for aplicado, todos os elementos irmãos anteriores serão selecionados; neste caso, os elementos selecionados são os mesmos que o .prevAll() sem seletor.
Para jQuery 1.6, o nó DOM ou o objeto jQuery, em vez do seletor, podem ser usados como o primeiro parâmetro do método .prevUntil().
Este método aceita uma expressão de seletor opcional como seu segundo parâmetro. Se este parâmetro for aplicado, os elementos serão filtrados com base na correspondência com o seletor.
