Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

window.matchMedia

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

Retourne un nouvel objet MediaQueryList contenant les résultats de la chaîne de caractères media query spécifiée.

Syntaxe

js
mql = window.matchMedia(mediaQueryString);

Ici, mediaQueryString est une chaîne de caractère représentant la media query pour laquelle on retourne un nouvel objet MediaQueryList.

Exemple

js
if (window.matchMedia("(min-width: 400px)").matches) {
  /* the view port is at least 400 pixels wide */
} else {
  /* the view port is less than 400 pixels wide */
}

Ce code permet de gérer la mise en page d'une manière différente quand l'écran est moins large.

Voir Utiliser les media queries avec du code pour plus d'exemples.

Spécifications

Specification
CSSOM View Module
# dom-window-matchmedia

Compatibilité des navigateurs

Voir aussi