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:

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

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

.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:

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

$('#test').parentsUntil('.zzz').prepend('!');

O código HTML ficará assim:

<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