Método parentsUntil() de iteração jQuery
Exemplo
Procurar os elementos ascendentes de <li class="item-a"> até <ul class="level-1"> e definir suas cores de fundo como vermelho. Encontre todos os elementos ascendentes com a classe "yes" de <li class="item-2"> até <ul class="level-1"> e defina suas bordas como azul:
$("li.item-a");.parentsUntil(".level-1");
.css("background-color", "red");
$("li.item-2");.parentsUntil($("ul.level-1"), ".yes");
.css("border", "3px solid blue");
Definição e uso
O método parentsUntil() obtém os elementos ascendentes de cada elemento da coleção de elementos correspondentes, até encontrar um elemento que correspondente ao seletor, nó DOM ou objeto jQuery.
Sintaxe 1
.parentsUntil(selector,filter)
| Parâmetros | Descrição |
|---|---|
| selector | Opcional. Valor de string, que define onde parar a correspondência de elementos ascendentes. |
| filter | Opcional. Valor de string, contendo a expressão de seletor usada para correspondência de elementos. |
Sintaxe 2
.parentsUntil(element,filter)
| Parâmetros | Descrição |
|---|---|
| element | Opcional. Nó DOM ou objeto jQuery, indicando onde parar a correspondência de elementos ascendentes. |
| 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 .parentsUntil() permite que busquemos os elementos ascendentes desses elementos no árvore DOM até encontrar um elemento que correspondente ao seletor (passado como parâmetro para o método). O objeto jQuery retornado contém todos os elementos ascendentes, exceto o elemento que correspondente ao seletor especificado pelo método .parentsUntil().
Se não houver correspondência ou se o seletor não for aplicado, todos os elementos ascendentes da seleção serão selecionados; neste caso, os elementos selecionados pelo método .parentsUntil() são os mesmos que seriam selecionados pelo .parents() sem seletor.
Para jQuery 1.6, nós podemos usar nós DOM ou objetos jQuery, em vez de seletores, como o primeiro parâmetro do método .parentsUntil().
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.
