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