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");

Experimente você mesmo

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.