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 CSS-Selektor-Liste 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().