Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Element.matches — preverjanje izbirnika CSS

Element.matches preveri, ali se določen element ujema z izbirnikom CSS. Vrne logično vrednost, ne elementa; neveljavna sintaksa izbirnika povzroči izjemo.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

element.matches(selectors)

element.matches(selectors) preveri sam element. Argument selectors je niz izbirnika CSS ali seznam izbirnikov, ločenih z vejicami. Rezultat je true, če se element ujema, sicer false.

Metoda ne išče med potomci kot querySelector() in ne najde ujemajočega se prednika kot closest(). Elementu ni treba biti priključen dokumentu; izbirniki, ki so odvisni od odnosov v drevesu, pa upoštevajo njegovo dejansko okolico.

Neveljaven izbirnik sproži DOMException z imenom SyntaxError, namesto da bi vrnil false.

To je DOM API, določen v DOM Standard, in ne funkcija ECMAScript. Sama prisotnost Node 24 ne dokazuje, da je ta API brskalnika podprt.

Primeri

const element = document.createElement('button');
element.className = 'action';

console.log(element.matches('button.action'));
console.log(element.matches('.missing'));
console.log(element.matches('.missing, .action'));

try {
  element.matches('[');
} catch (error) {
  console.log(error.name);
}

Rezultat

true
false
true
SyntaxError

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri