Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Window.matchMedia e MediaQueryList.matches

Controlla in JavaScript se una media query CSS è soddisfatta e reagisci solo quando cambia il risultato.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

const mediaQueryList = window.matchMedia(mediaQueryString);
const matchesNow = mediaQueryList.matches;

window.matchMedia(query) riceve una media query CSS come stringa e restituisce un nuovo oggetto MediaQueryList a ogni chiamata, non un booleano. Passa solo la query, senza @media né un blocco di regole. Racchiudi tra parentesi le condizioni sulle caratteristiche del mezzo: (max-width: 600px) verifica se il viewport è largo al massimo 600 pixel CSS, limite incluso.

Leggi list.matches senza parentesi. È una proprietà booleana di sola lettura: vale true se l’elenco di media query è vuoto o se il documento soddisfa al momento almeno una query dell’elenco separato da virgole, altrimenti vale false. false non segnala un errore di sintassi. Una nuova lettura sullo stesso oggetto fornisce il risultato corrente; un booleano salvato in precedenza non si aggiorna da solo.

Se ti serve lo stato iniziale, leggi list.matches, poi usa list.addEventListener("change", handler) per seguire le variazioni. L’evento scatta quando il risultato passa da true a false o viceversa, non a ogni ridimensionamento. Leggi il nuovo risultato in event.matches. Quando non ti servono più gli aggiornamenti, chiama list.removeEventListener("change", handler) con la stessa funzione.

Questa è un’API del browser, non fa parte di ECMAScript 2024. Non dare per scontato che sia disponibile fuori da una finestra del browser. Se devi soltanto modificare gli stili, usa @media in CSS: matchMedia() non applica stili da solo.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>matchMedia example</title>
</head>
<body>
  <script>
    console.log(window.matchMedia("all").matches);
    console.log(window.matchMedia("not all").matches);
  </script>
</body>
</html>

Risultato

true
false

Apri il file HTML in un browser e controlla la console. `all` corrisponde a tutti i mezzi e `not all` a nessuno, quindi vedrai prima `true` e poi `false`, indipendentemente dalla larghezza del viewport.

Lezioni correlate

  • JavaScript · Lezione 3 · Avanzato · Versione: 4
  • JavaScript · Lezione 6 · Avanzato · Versione: 4
  • JavaScript · Lezione 7 · Avanzato · Versione: 4
  • JavaScript · Lezione 19 · Avanzato · Versione: 4
  • JavaScript · Lezione 41 · Intermedio · Versione: 3
  • JavaScript · Lezione 42 · Intermedio · Versione: 3
  • JavaScript · Lezione 43 · Intermedio · Versione: 3

Fonti