Element: matches() Methode

Syntax

matches(selectors)

Parameter

selectors

Ein String, der gültige CSS-Selektoren enthält, um das Element zu testen.

Rückgabewert

true, wenn das Element den selectors entspricht. Andernfalls false.

Ausnahmen

SyntaxError DOMException

Wird ausgelöst, wenn selectors nicht als Liste von CSS-Selektoren geparst werden kann.

Beispiele

HTML

<ul id="birds">
  <li>Orange-winged parrot</li>
  <li class="endangered">Philippine eagle</li>
  <li>Great white pelican</li>
</ul>

JavaScript

const birds = document.querySelectorAll("li");

for (const bird of birds) {
  if (bird.matches(".endangered")) {
    console.log(`The ${bird.textContent} is endangered!`);
  }
}

Dies wird "The Philippine eagle is endangered!" in die Konsole ausgeben, da das Element tatsächlich ein class Attribut mit dem Wert endangered hat.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• CSS-Selektoren Modul
• Andere Element Methoden, die Selektoren verwenden: Element.querySelector(), Element.querySelectorAll(), und element.closest().