Método HTML DOM matches()
❮ O Objeto ElementoExemplo
Determine se um elemento corresponde a um seletor CSS:
var element = document.getElementById("myElement");
if (element.matches(".container")) {
element.innerHTML = "This element matches the \".container\" CSS selector";
} else {
element.innerHTML = "This element does not match the \".container\" CSS selector";
}
Definição e uso
O matches()
método retorna um valor booleano indicando se um elemento corresponde a um seletor CSS específico ou não.
Dica: para obter uma lista de todos os seletores de CSS, consulte nossa Referência de seletores de CSS .
Suporte ao navegador
Os números na tabela especificam a primeira versão do navegador que oferece suporte total ao método.
Method | |||||
---|---|---|---|---|---|
matches() | 33.0 | 18.0 | 34.0 | 7.0 | 21.0 |
Sintaxe
element.matches(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 (See "More Examples"). Tip: For a list of all CSS Selectors, look at our CSS Selectors Reference. |
Detalhes técnicos
Valor de retorno: |
Um booleano, indicando se o elemento pode ser correspondido pelo seletor CSS:
|
---|
Mais exemplos
Exemplo
Descubra se um elemento corresponde a um dos vários seletores:
var element = document.getElementById("myElement");
if (element.matches(".container, .wrapper")) {
element.innerHTML = "This element matches either the \".container\" CSS selector or the \".wrapper\" selector.";
} else {
element.innerHTML = "This element does not match any of the selectors.";
}
Páginas relacionadas
Referência JavaScript: O método element.closest() .
❮ O Objeto Elemento