tutoriais mais recente desenvolvimento web
 

jQuery closest() Method

<Métodos jQuery atravessando

Exemplo

Retornar o primeiro ancestral do <span> , que é um <ul> elemento:

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

Resultado:

body (great-great-grandparent)
div (great-grandparent)
    ul (second ancestor - second grandparent)
      ul (first ancestor - first grandparent)
    • li (direct parent)  span  
     
Tente você mesmo "

Definição e Uso

O closest() método retorna o primeiro ancestral do elemento selecionado.

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

A árvore DOM: Este método transversal para cima do elemento atual, todo o caminho até o elemento raiz do documento (<html>) , para encontrar o primeiro antepassado de elementos DOM.

Este método é semelhante ao parents() , em que ambos atravessam a árvore DOM. As diferenças são as seguintes:

closest()

  • Começa com o elemento atual
  • Viaja até a árvore DOM e retorna o primeiro ancestral (single) que corresponda à expressão passada
  • O objeto jQuery retornado contém zero ou um elemento

parents()

  • Começa com o elemento pai
  • Viaja até a árvore DOM e retorna todos os antepassados ​​que corresponde à expressão passada
  • O objeto jQuery retornado contém zero ou mais do que um elemento

Outros métodos relacionados:

  • parent() - retorna o elemento pai direto do elemento selecionado
  • parentsUntil() - retorna todos os elementos ancestrais entre dois argumentos dados

Sintaxe

Devolver o primeiro ancestral do elemento selecionado:

$(selector).closest( filter )

Devolver o primeiro ancestral usando um contexto DOM para procurar a árvore DOM dentro:

$(selector).closest( filter,context )

Parâmetro Descrição
filter Requeridos. Especifica uma expressão selector, elemento ou objeto jQuery para restringir a pesquisa ancestral
context Opcional. Um elemento DOM dentro do qual um elemento de correspondência pode ser encontrada

Tente você mesmo - Exemplos

Retornar o primeiro ancestral do <span> , que é um <span> elemento
Como esse método começa com o elemento atual, a busca pela primeira <span> de <span> , irá retornar <span> .

Passar para um elemento DOM como o contexto em que para procurar o primeiro elemento ancestral
Usando ambos os parâmetros para passar em um elemento DOM como o contexto em que para procurar o primeiro <ul> elemento.


<Métodos jQuery atravessando