Método jQuery mais próximo()
❮ Métodos de travessia do jQuery
Exemplo
Retorna o primeiro ancestral de <span>, que é um elemento <ul>:
$(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
Definição e uso
O método mais próximo() retorna o primeiro ancestral do elemento selecionado.
Um ancestral é um pai, avô, bisavô e assim por diante.
A árvore DOM: Este método percorre para cima a partir do elemento atual, até o elemento raiz do documento (<html>), para encontrar o primeiro ancestral dos elementos DOM.
Esse método é semelhante ao parent() , pois ambos percorrem a árvore DOM. As diferenças são as seguintes:
mais próximo()
- Começa com o elemento atual
- Percorre a árvore DOM e retorna o primeiro ancestral (único) que corresponde à expressão passada
- O objeto jQuery retornado contém zero ou um elemento
pais()
- Começa com o elemento pai
- Percorre a árvore DOM e retorna todos os ancestrais que correspondem à expressão passada
- O objeto jQuery retornado contém zero ou mais de um elemento
Outros métodos relacionados:
- parent() - retorna o elemento pai direto do elemento selecionado
- ParentsUntil() - retorna todos os elementos ancestrais entre dois argumentos fornecidos
Sintaxe
Retorna o primeiro ancestral do elemento selecionado:
$(selector).closest(filter)
Retorne o primeiro ancestral usando um contexto DOM para pesquisar a árvore DOM em:
$(selector).closest(filter,context)
Parameter | Description |
---|---|
filter | Required. Specifies a selector expression, element or jQuery object to narrow down the ancestor search |
context | Optional. A DOM element within which a matching element may be found |
Experimente você mesmo - Exemplos
Como esse método começa com o elemento atual, uma pesquisa pelo primeiro <span> de <span> retornará <span>.
Usando ambos os parâmetros para passar um elemento DOM como o contexto no qual pesquisar o primeiro elemento <ul>.
❮ Métodos de travessia do jQuery