Método HTML DOM mais próximo()
❮ O Objeto ElementoExemplo
Encontre o elemento mais próximo que corresponda ao seletor CSS e dê uma borda amarela:
var element = document.getElementById("myElement");
var closest =
element.closest(".container");
if (closest) {
closest.style.border = "10px solid yellow";
}
Definição e uso
O closest()
método pesquisa na árvore DOM o elemento mais próximo que corresponda a um seletor CSS especificado. Ele começa no próprio elemento e, em seguida, testa o pai, o avô e assim por diante até que uma correspondência seja encontrada. Se uma correspondência não for encontrada, esse método retornará null .
Suporte ao navegador
Os números na tabela especificam a primeira versão do navegador que oferece suporte total ao método.
Method | |||||
---|---|---|---|---|---|
closest() | 41.0 | 15.0 | 35.0 | 6.0 | 28.0 |
Sintaxe
element.closest(selectors)
Valores de parâmetro
Parameter | Description |
---|---|
selectors |
Required. Specifies one or more CSS selectors to match the element. These are used to select HTML elements based on their id, classes, types, attributes, values of attributes, etc. For multiple selectors, separate each selector with a comma. The returned element depends on which element that is first found in the document. Tip: For a list of all CSS Selectors, look at our CSS Selectors Reference. |
Detalhes técnicos
Valor de retorno: |
O elemento ancestral mais próximo, ou o próprio elemento, que corresponde ao(s) seletor(es) CSS especificado(s). Se nenhuma correspondência for encontrada, null será retornado. Lança uma exceção SYNTAX_ERR se os seletores especificados forem inválidos. |
---|
Páginas relacionadas
Referência JavaScript: O método element.matches() .
❮ O Objeto Elemento