Método parentsUntil() de navegação jQuery
Exemplo
Procurar os elementos ascendentes de <li class="item-a"> até <ul class="level-1">, e configurá-los com fundo vermelho. Encontre todos os elementos ascendentes de <li class="item-2"> com a classe "yes" até <ul class="level-1">, e configure suas bordas para 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 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 .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 são os mesmos que seriam selecionados pelo .parents() sem seletor.
Para jQuery 1.6, nós podemos usar nó DOM ou objeto jQuery, em vez de seletor, 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.