CKTIS / JavaScript
window.matchMedia — verificare le media query
window.matchMedia verifica una media query CSS da JavaScript. Restituisce una MediaQueryList con il risultato corrente in matches e permette di osservare i cambiamenti nella corrispondenza della query.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
const mql = window.matchMedia(query);
mql.matches;
mql.media;
mql.addEventListener("change", handler);
mql.removeEventListener("change", handler);window.matchMedia(query) crea una nuova MediaQueryList, non un valore booleano. Leggi matches per ottenere il risultato corrente; media contiene la query serializzata.
Passa una query CSS come "(min-width: 768px)", senza @media. La caratteristica multimediale width si riferisce alla larghezza dell’area di visualizzazione (viewport) nei media continui e alla larghezza del riquadro di pagina (page box) nei media paginati, come la stampa. L’unità px indica i pixel CSS. Questa query non è limitata al tipo di media screen. Il metodo verifica una condizione; non applica stili da solo.
Questa è un’API del browser di CSSOM View, non una funzionalità ECMAScript. Prima di chiamare window.matchMedia(query), verifica typeof window !== "undefined" && typeof window.matchMedia === "function"; Node 24 da solo non dimostra che l’API sia supportata. Questo controllo non verifica la disponibilità dei metodi per gestire i listener degli eventi sull’oggetto restituito.
Leggi il risultato iniziale in mql.matches, dove mql è la MediaQueryList restituita. Registra il gestore con mql.addEventListener("change", handler) solo se typeof mql.addEventListener === "function" && typeof mql.removeEventListener === "function". Se manca uno dei due metodi, salta la registrazione; puoi comunque leggere matches. L’evento segnala un cambiamento del risultato, non ogni variazione delle dimensioni; event.matches fornisce il nuovo risultato. Se hai registrato il gestore, durante la pulizia chiama mql.removeEventListener("change", handler) con la stessa funzione.
L’esempio usa all e la sua negazione not all, quindi il risultato è indipendente dalle dimensioni della finestra.
Esempi
const always = window.matchMedia("all");
const never = window.matchMedia("not all");
console.log(always.matches);
console.log(never.matches);Risultato
true false
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.