Método parentsUntil

O método parentsUntil obtém todos os pais de um elemento - não apenas o pai direto, mas também o avô, bisavô e assim por diante até o elemento raiz (ou seja, até a tag html). A busca por pais termina ao atingir um pai que corresponda ao seletor especificado como parâmetro deste método.

Sintaxe

Buscar pai até o pai que corresponda a um seletor, o seletor pode ser um nó DOM, uma expressão ou um objeto jQuery, também é possível usar o segundo parâmetro para filtragem adicional. Ambos os parâmetros são opcionais:

javascript.parentsUntil([seletor], [filtro]);

O seletor pode ser omitido, neste caso o método se comportará de forma semelhante ao método parents:

javascript.parentsUntil();

Exemplo

Vamos encontrar o elemento #test depois encontrar todos os seus pais até o elemento com a classe zzz usando parentsUntil e adicionar o texto '!' no início usando prepend:

html<div>
  <div class="zzz">
    <div class="www">
      <div class="www">
        <p id="test">texto</p>
      </div>
    </div>
  </div>
</div>
javascript$('#test').parentsUntil('.zzz').prepend('!');

O código HTML ficará assim:

html<div>
  <div class="zzz">
    <div class="www">
      !
      <div class="www">
        !<p id="test">texto</p>
      </div>
    </div>
  </div>
</div>

Veja também

  • método parent,
    que permite obter o pai direto de um elemento
  • método closest,
    que permite obter o elemento pai mais próximo que satisfaça um seletor
  • método parents,
    que permite obter todos os pais de um elemento
  • método children,
    que permite obter os elementos filhos de um elemento