La règle @ @media permet d'associer un ensemble d'instructions imbriquées (délimité par des accolades) avec une condition définie par une requête média. La règle @media peut être utilisé au niveau le plus haut de la feuille de style et également à l'intérieur d'un groupe de règles conditionnel.
@media (max-width: 600px) {
.sidebar {
display: none;
}
}
Il est possible de manipuler la règle @ @media via le CSSOM (et JavaScript) notamment grâce à l'interface {{domxref("CSSMediaRule")}}.
Une requête média (type <media-query>) est composée d'un type de média (optionnel) et/ou de différentes caractéristiques relatives au média. Une requête média peut être imbriquée dans une autre règle conditionnelle.
/* Au niveau le plus haut du code */
@media screen and (min-width: 900px) {
article {
padding: 1rem 3rem;
}
}
/* Imbriquée dans une autre règle-@ conditionnelle */
@supports (display: flex) {
@media screen and (min-width: 900px) {
article {
display: flex;
}
}
}
Pour plus d'informations sur la syntaxe des requêtes média, voir Utiliser les requêtes média.
{{csssyntax}}
{{page("/fr/docs/Web/CSS/Requêtes_média/Utiliser_les_Media_queries","Caractéristiques_média_(media_features)")}}
@media print {
body { font-size: 10pt }
}
@media screen {
body { font-size: 13px }
}
@media screen, print {
body { line-height: 1.2 }
}
@media only screen
and (min-width: 320px)
and (max-width: 480px)
and (-webkit-min-device-pixel-ratio: 2) {
body { line-height: 1.4 }
}
Avec la mise à jour de la spécification pour les requêtes média, une nouvelle syntaxe, plus concise, peut être utilisée pour les tests d'intervalle :
@media (height > 600px) {
body { line-height: 1.4; }
}
@media (400px <= width <= 700px) {
body { line-height: 1.4; }
}
Pour plus d'exemples, voir Utiliser les requêtes média.
Pour une meilleure interaction, notamment avec les personnes qui zooment sur une page pour accroître la taille du texte ou qui définissent une taille de police par défaut pour l'ensemble du navigateur, on utilisera l'unité em comme valeur pour les requêtes média lorsqu'il faut utiliser une longueur ({{cssxref("<length>")}}).
Les unités em et px sont toutes les deux valides mais em s'adapte mieux quand la taille de la police du navigateur a été ajustée.
On privilégiera, autant que possible, les requêtes média de la spécification de niveau 4 afin d'améliorer l'ergonomie. On pourra, par exemple, se baser sur prefers-reduced-motion afin de détecter si l'utilisateur souhaite minimiser les animations ou les déplacements.
Les requêtes média fournissent des informations quant aux capacités de l'appareil avec lequel on navigue. L'ensemble de ces capacités peut être détourné afin de construire une empreinte qui identifie l'appareil ou le catégorise de façon indésirée.
Pour ces raisons, un navigateur peut choisir de mentir sur les valeurs renvoyées afin de contourner ce pistage. Ainsi, si la détection d'empreinte numérique est désactivée dans Firefox, la plupart des caractéristiques média renverront leurs valeurs par défaut afin d'éviter leur utilisation pour du pistage.
| Spécification | Commentaires | Retours |
|---|---|---|
| {{SpecName('CSS5 Media Queries', '#at-media5', '@media')}} | Réintègre light-level, inverted-colors et les requêtes média personnalisées qui avaient été retirées la spécification de niveau 4.Ajout des caractéristiques média prefers-reduced-motion, prefers-reduced-transparency, prefers-contrast et prefers-color-scheme. |
Issues GitHub pour les brouillons du groupe de travail CSS (en anglais) |
| {{SpecName('CSS3 Conditional', '#at-media', '@media')}} | Définition de la syntaxe de base pour la règle @media. |
Issues GitHub pour les brouillons du groupe de travail CSS (en anglais) |
| {{SpecName('CSS4 Media Queries', '#media', '@media')}} |
Ajout des caractéristiques média |
Issues GitHub pour les brouillons du groupe de travail CSS (en anglais) |
| {{SpecName('CSS3 Media Queries', '#media0', '@media')}} | ||
| {{SpecName('CSS2.1', 'media.html#at-media-rule', '@media')}} | Définition initiale. |
{{Compat("css.at-rules.media")}}