Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Window.matchMedia et MediaQueryList.matches

Vérifiez en JavaScript si une requête média CSS est satisfaite et réagissez uniquement lorsque le résultat change.

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

Syntaxe

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

window.matchMedia(query) prend une requête média CSS sous forme de chaîne et renvoie à chaque appel un nouvel objet MediaQueryList, pas un booléen. Passez uniquement la requête, sans @media ni bloc de règles. Placez les conditions sur les caractéristiques du média entre parenthèses : (max-width: 600px) teste si la zone d’affichage fait au plus 600 pixels CSS de large, borne comprise.

Lisez list.matches sans parenthèses. Cette propriété booléenne en lecture seule vaut true si la liste de requêtes média est vide ou si le document satisfait actuellement au moins une requête de la liste séparée par des virgules, et false sinon. false ne signale pas une erreur de syntaxe. Relire la propriété sur le même objet donne le résultat actuel ; un booléen enregistré auparavant ne se met pas à jour tout seul.

Si vous avez besoin de l’état initial, lisez list.matches, puis utilisez list.addEventListener("change", handler) pour suivre les changements. L’événement se déclenche quand le résultat bascule entre true et false, pas à chaque redimensionnement. Le nouveau résultat se trouve dans event.matches. Pour arrêter l’écoute, appelez list.removeEventListener("change", handler) avec la même fonction.

Cette API relève du navigateur, pas d’ECMAScript 2024. Ne supposez pas qu’elle est disponible en dehors d’une fenêtre de navigateur. Si vous voulez seulement changer les styles, utilisez @media en CSS : matchMedia() n’applique aucun style par lui-même.

Exemples

<!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>

Résultat

true
false

Ouvrez le fichier HTML dans un navigateur et consultez la console. `all` correspond à tous les médias et `not all` à aucun : la console affiche donc `true` puis `false`, quelle que soit la largeur de la zone d’affichage.

Leçons associées

  • JavaScript · Leçon 3 · Avancé · Version : 4
  • JavaScript · Leçon 6 · Avancé · Version : 4
  • JavaScript · Leçon 7 · Avancé · Version : 4
  • JavaScript · Leçon 19 · Avancé · Version : 4
  • JavaScript · Leçon 41 · Intermédiaire · Version : 3
  • JavaScript · Leçon 42 · Intermédiaire · Version : 3
  • JavaScript · Leçon 43 · Intermédiaire · Version : 3

Sources