Método jQuery parentUntil()

❮ Métodos de travessia do jQuery

Exemplo

Retorne todos os elementos ancestrais entre <span> e <div>:

$(document).ready(function(){
  $("span").parentsUntil("div").css({"color": "red", "border": "2px solid red"});
});

Resultado:

body (great-great-grandparent)
div (great-grandparent)
    ul (grandparent)
  • li (direct parent) span

Definição e uso

O método parentUntil() retorna todos os elementos ancestrais entre o seletor e stop .

Um ancestral é um pai, avô, bisavô e assim por diante.

A árvore DOM: Este método percorre para cima do elemento pai ao longo dos ancestrais dos elementos DOM, até o elemento raiz do documento, até atingir um elemento específico.

Nota: Se ambos os parâmetros estiverem vazios, este método retornará todos os elementos ancestrais (o mesmo que o método parent() ).

Métodos relacionados:

  • parent() - retorna o elemento pai direto do elemento selecionado
  • Parents() - retorna todos os elementos ancestrais do elemento selecionado
  • mais próximo() - retorna o primeiro ancestral do elemento selecionado


Sintaxe

$(selector).parentsUntil(stop,filter)

Parameter Description
stop Optional. A selector expression, element or jQuery object indicating where to stop the search for matching ancestor elements
filter Optional. Specifies a selector expression to narrow down the search for ancestors between selector and stop

Note: To return multiple ancestors, separate each expression with a comma.

Experimente você mesmo - Exemplos


Como usar os dois parâmetros para filtrar a pesquisa de um elemento específico entre <span> e <div>.


Como retornar vários ancestrais entre <span> e <body>.


Retorna todos os ancestrais entre <span> e <div> usando um elemento DOM.


Usando um elemento DOM para restringir a pesquisa ancestral de elementos <ul> entre <span> e <div>.


❮ Métodos de travessia do jQuery