Media queries
=============

**Les requêtes média (*media queries*)** permettent de modifier l'apparence d'un site ou d'une application en fonction du type d'appareil (impression ou écran par exemple) et de ses caractéristiques (la résolution d'écran ou la largeur de la zone d'affichage (*viewport*) par exemple).

Les requêtes média sont utilisées afin :

* D'appliquer certains styles de façon conditionnelle avec le CSS grâce aux règles @ `@media` et `@import`.
* De cibler certains médias pour les éléments `<style>`, `<link>`, `<source>` et d'autres éléments HTML grâce à l'attribut `media=`.
* De tester et surveiller l'état d'un média grâce aux méthodes `Window.matchMedia()` et `MediaQueryList.addListener()` (en-US).

**Note :** Les exemples de cet article utilisent `@media` à des fins d'illustration. Toutefois, la syntaxe est la même pour les différents types de requêtes média.

Syntaxe
-------

Une requête média se compose d'un *type de média* optionnel et d'une ou plusieurs expressions de *caractéristiques de média*. Plusieurs requêtes peuvent être combinées entre elles grâce à des opérateurs logiques. Les requêtes média ne sont pas sensibles à la casse.

Une requête média vaut `true` si le type de média correspond à l'appareil utilisé pour l'affichage du document et si toutes les expressions relatives aux caractéristiques sont vraies. Les requêtes qui utilisent des types de média inconnus valent toujours `false`.

**Note :** Lorsqu'une feuille de style est attachée à un élément `<link>` comportant une requếte média, cette feuille de style sera toujours téléchargée, même si la requête renvoie `false`. Toutefois, le contenu de cette feuille n'est pas appliquée tant que le résultat de la requête ne devient pas `true`.

### Types de média

Un type de média définit une catégorie générale d'appareil. Le type de média est optionnel dans une requête média, sauf si celle-ci utilise les opérateurs logiques `not` ou `only`. Par défaut, le type de média utilisé est `all`.

`all`

Correspond pour tous les appareils.

`print`

Correspond aux matériaux paginés et aux documents consultés en aperçu avant impression. Pour plus d'informations, voir l'article sur les médias paginés.

`screen`

Correspond aux appareils dotés d'un écran.

`speech`

Correspond aux outils de synthèse vocale.


**Note :** Les types de média dépréciés CSS2.1 et Media Queries 3 ont défini plusieurs types additionnels (`tty`, `tv`, `projection`, `handheld`, `braille`, `embossed`, and `aural`) qui ont ensuite été dépréciés avec Media Queries 4. Ces types ne doivent donc plus être utilisés. Le type `aural` a été remplacé par le type `speech`.

### Caractéristiques média (*media features*)

Les caractéristiques média décrivent certaines caractéristiques spécifiques de l'agent utilisateur, de l'appareil d'affichage ou de l'environnement. Les expressions de caractéristique média testent leur présence ou leur valeur. Chaque expression de caractéristique doit être entourée de parenthèses.

| Nom | Résumé | Notes |
| --- | --- | --- |
| `width` | La largeur de la zone d'affichage (*viewport*) |  |
| `height` | La hauteur de la zone d'affichage |  |
| `aspect-ratio` | Le rapport largeur/hauteur de la zone d'affichage |  |
| `orientation` | L'orientation la zone d'affichage |  |
| `resolution` | La densité de pixel pour l'appareil d'affichage |  |
| `scan` | Le processus de scan de l'appareil d'affichage |  |
| `grid` | Le type d'écran de l'appareil : matriciel ou grille ? |  |
| `update` | La fréquence de modification du contenu par l'appareil d'affichage | Ajoutée avec le niveau 4 du module de spécification *Media Queries*. |
| `overflow-block` | La façon dont l'appareil d'affichage gère le contenu qui dépasse de la zone d'affichage selon l'axe de bloc | Ajoutée avec le niveau 4 du module de spécification *Media Queries*. |
| `overflow-inline` | La possibilité de faire défiler (*scroll*) le contenu qui dépasse de la zone d'affichage sur l'axe en ligne | Ajoutée avec le niveau 4 du module de spécification *Media Queries*. |
| `color` | Le nombre de bits pour chaque composante de couleur pour l'appareil d'affichage (ou 0 si l'appareil ne gère pas les couleurs) |  |
| `color-gamut` | Un intervalle approximatif des couleurs prises en charge par l'agent utilisateur et l'appareil d'affichage | Ajoutée avec le niveau 4 du module de spécification *Media Queries*. |
| `color-index` | Le nombre d'éléments dans le tableau des couleurs de l'appareil d'affichage (ou 0 si l'appareil ne dispose pas d'un tel tableau) |  |
| `display-mode` | Le mode d'affichage de l'application, tel qu'indiqué par la propriété `display` du manifeste | Définie dans la spécification pour les manifestes des applications web. |
| `monochrome` | Le nombre de bits par pixel pour le *frame buffer* monochrome de l'appareil d'affichage ou 0 si l'appareil n'est pas monochrome |  |
| `inverted-colors` | L'inversion (ou non) des couleurs par l'agent utilisateur ou le système d'exploitation | Reportée au niveau 5 du module de spécification *Media Queries*. |
| `pointer` | La présence d'un appareil de pointage comme mécanisme de saisie principal et sa précision | Ajoutée avec le niveau 4 du module de spécification *Media Queries*. |
| `hover` | La capacité du mécanisme de saisie principal à survoler les éléments | Ajoutée avec le niveau 4 du module de spécification *Media Queries*. |
| `any-pointer` | La présence d'un appareil de pointage parmi les mécanismes de saisie et sa précision | Ajoutée avec le niveau 4 du module de spécification *Media Queries*. |
| `any-hover` | La capacité d'un des mécanismes de saisie à survoler les éléments | Ajoutée avec le niveau 4 du module de spécification *Media Queries*. |
| `light-level` | Le niveau de luminosité de l'environnement | Ajoutée avec le niveau 5 du module de spécification *Media Queries*. |
| `prefers-reduced-motion` | L'utilisateur préfère que la quantité de mouvement sur la page soit réduite. | Ajoutée avec le niveau 5 du module de spécification *Media Queries*. |
| `prefers-reduced-transparency` (en-US) | L'utilisateur préfère que la transparence utilisée sur la page soit réduite. | Ajoutée avec le niveau 5 du module de spécification *Media Queries*. |
| `prefers-contrast` | L'utilisateur préfère que le contraste soit augmenté ou réduit entre des couleurs proches. | Ajoutée avec le niveau 5 du module de spécification *Media Queries*. |
| `prefers-color-scheme` | L'utilisateur préfère utiliser un thème clair ou un thème sombre. | Ajoutée avec le niveau 5 du module de spécification *Media Queries*. |
| `forced-colors` | Détecte si l'agent utilisateur restreint la palette de couleurs. | Ajoutée avec le niveau 5 du module de spécification *Media Queries*. |
| `scripting` | La disponibilité des fonctions de script (JavaScript par exemple) | Reportée au niveau 5 du module de spécification *Media Queries*. |
| `device-width` 
Obsolète
 | La largeur de la surface de rendu pour l'appareil d'affichage | Dépréciée par le niveau 4 du module de spécification *Media Queries*. |
| `device-height` 
Obsolète
 | La hauteur de la surface de rendu pour l'appareil d'affichage | Dépréciée par le niveau 4 du module de spécification *Media Queries*. |
| `device-aspect-ratio` 
Obsolète
 | Le rapport largeur/hauteur de la surface de rendu pour l'appareil d'affichage | Dépréciée par le niveau 4 du module de spécification *Media Queries*. |

### Opérateurs logiques

Les opérateurs logiques `not`, `and` et `only` peuvent être utilisés afin de construire une requête média complexe. Il est aussi possible de combiner plusieurs requêtes média en les séparant par des virgules.

#### `and`

L'opérateur `and` permet de combiner plusieurs requêtes média en une seule. Pour que la requête résultante soit vraie, il faut que chacune des sous-requêtes soit vraie. Cet opérateur est également utilisé afin de relier des caractéristiques média avec des types de média.

#### `not`

L'opérateur `not` est utilisé afin d'obtenir le résultat opposé d'une requête média (il renvoie `true` si l'opérande renvoie `false`). S'il est utilisé dans une liste de requêtes séparées par des virgules, il ne nie que la requête sur laquelle il est appliqué. Si l'opérateur `not` est utilisé, la requête doit nécessairement contenir un type de média.

**Note :** Pour la spécification de niveau 3, l'opérateur `not` ne peut pas être utilisé afin de prendre l'opposé d'une expression de caractéristique de média, il ne peut servir qu'à l'échelle d'une requête média entière.

#### `only`

L'opérateur `only` est utilisé afin d'appliquer un style uniquement si l'intégralité de la requête est vérifiée. Il permet d'empêcher les anciens navigateurs d'appliquer les styles concernés. Si on utilise pas `only`, un ancien navigateur interprètera `screen and (max-width: 500px)` comme `screen` uniquement (appliquant ainsi le style à tous les écrans). Si l'opérateur `only` est utilisé, la requête doit nécessairement contenir un type de média.

#### `,` (virgule)

Les virgules permettent de combiner plusieurs requêtes en une. Chaque requête est traitée séparément. Autrement dit, si une des requêtes de la liste renvoie `true`, toute la requête combinée renverra `true`. En ce sens, l'opérateur `,` agit comme un opérateur booléen `or`.

Cibler des types de média
-------------------------

Les types de média décrivent la catégorie générale de l'appareil utilisé. Bien que la plupart des sites web soient principalement conçus pour être affichés sur des écrans, il est possible d'avoir des styles spécifiques pour les impressions ou pour les lecteurs d'écran. Voici une requête qui permet de cibler les imprimantes ou autres appareils imprimant le contenu sur plusieurs pages :


```css
@media print { ... }
```


Il est possible de cibler plusieurs types à la fois. La règle suivante permet de cibler les écrans et les appareils d'impression :


```css
@media screen, print { ... }
```


Pour une liste complète des types de média, voir ci-avant. Ces types étant très génériques, peu de valeurs sont disponibles. Afin d'avoir un ciblage plus fin, on pourra utiliser les caractéristiques média.

Cibler des caractéristiques média
---------------------------------

Les caractéristiques média décrivent les caractéristiques spécifiques d'un agent utilisateur, d'un appareil d'affichage ou de l'environnement. On peut ainsi cibler différents styles pour les écrans larges, pour les ordinateurs qui disposent d'une souris ou pour les appareils utilisés dans une faible luminosité. Dans l'exemple qui suit, on a une requête qui vérifie si le mécanisme de saisie principal de l'appareil peut survoler les éléments :


```css
@media (hover: hover) { ... }
```


De nombreuses caractéristiques média sont des caractéristiques portant sur un intervalle et peuvent être préfixées par `min-` ou `max-` afin d'exprimer des seuils de valeurs. Par exemple, la requête suivante permet d'appliquer des styles à condition que la largeur de la zone d'affichage (*viewport*) soit inférieure à 1250px :


```css
@media (max-width: 1250px) { ... }
```


**Note :** Selon la spécification du W3C, les barres de défilement font partie des dimensions de la page. Ainsi la barre de défilement vertical s'ajoute à la largeur du document tandis que la barre de défilement horizontal s'ajoute à la hauteur du document. Cependant tous les navigateurs n'ont pas adopté cette recommandation (Chrome par exemple) et tous n'ont pas opté pour la même taille de barre de défilement, ce qui mène à un développement plus difficile pour assurer une comptabilité sur tous les navigateurs.

Si on utilise une caractéristique média sans indiquer de valeur, la requête sera vérifiée tant que la valeur de cette caractéristique n'est pas nulle (ou `none` pour la spécification de niveau 4). Ainsi, la requête suivante permettra d'appliquer les styles qu'elle contient si l'appareil peut afficher des couleurs :


```css
@media (color) { ... }
```


Si une caractéristique ne s'applique pas à l'appareil, les expressions utilisant cette caractéristique renverront `false`. Ainsi, la requête suivante aura toujours la valeur `false` car aucun appareil de synthèse vocale ne possède de caractéristique relative à ses proportions d'écran :


```css
@media speech and (aspect-ratio: 11/5) { ... }
```


Pour plus d'exemples, voir les pages de référence de chacune de ces caractéristiques depuis le tableau ci-dessus.

Créer des requêtes média complexes
----------------------------------

Il est parfois nécessaire d'avoir une requête qui repose sur plusieurs conditions. Pour cela, on peut utiliser les opérateurs logiques : `not`, `and`, `only` et la virgule (`,`) afin de combiner plusieurs requêtes média.

Dans l'exemple précédent, on a utilisé l'opérateur `and` afin de combiner un type de média et une caractéristique média. Cet opérateur peut également servir à assembler plusieurs requêtes média pour en former la conjonction logique. L'opérateur `not` permet d'obtenir la négation d'une requête média tandis que l'opérateur `only` empêche les anciens navigateurs d'appliquer les styles qu'une requête contient.

**Note :** Dans la plupart des cas, le type de média `all` est utilisé par défaut si aucun autre type n'est fourni. Toutefois, lorsqu'on utilise les opérateurs `not` ou `only`, il est nécessaire de fournir un type de média explicite.

### Combiner plusieurs types ou caractéristiques

Le mot-clé `and` permet de combiner une caractéristique média avec un type de média ou avec d'autres caractéristiques média. L'exemple suivant permet de restreindre l'application d'un style aux appareils orientés en mode paysage et dont la largeur mesure au moins 30ems :


```css
@media (min-width: 30em) and (orientation: landscape) { ... }
```


Si on souhaite restreindre ces règles aux écrans, on pourra ajouter une clause avec le type de média `screen` :


```css
@media screen and (min-width: 30em) and (orientation: landscape) { ... }
```

### Tester plusieurs requêtes

La virgule peut être utilisée afin de créer une disjonction (un OU logique) sur différentes clauses (types de média, caractéristiques ou états). Dans l'exemple qui suit, les styles de la requête sont appliqués si l'appareil possède une hauteur supérieure ou égale à 680 pixels ou si l'écran est en mode portrait :


```css
@media (min-height: 680px), screen and (orientation: portrait) { ... }
```


Avec cet exemple, si l'utilisateur utilise une imprimante et que la page mesure 800 pixels de haut, la requête média aurait été vérifiée. Il en aurait été de même si l'utilisateur avait utilisé un smartphone avec une zone d'affichage haute de 480 pixels en portrait car la deuxième clause aurait renvoyée `true`.

### Opérer une négation

Le mot-clé `not` permet d'inverser le résultat d'une requête. Il inversera uniquement la requête sur laquelle il est appliqué (et non la liste des requêtes s'il est utilisé au sein de requêtes séparées par des virgules). Le mot-clé `not` ne peut pas être utilisé afin d'inverser une caractéristique média, il peut uniquement être utilisé pour une requête média complète. Dans la requête qui suit, l'opérateur `not` est évalué en dernier :


```css
@media not all and (monochrome) { ... }
```


La requête précédente est donc équivalente à :


```css
@media not (all and (monochrome)) { ... }
```


Mais elle n'est pas équivalente à :


```css
@media (not all) and (monochrome) { ... }
```


De même :


```css
@media not screen and (color), print and (color) { ... }
```


sera évaluée comme :


```css
@media (not (screen and (color))), print and (color) { ... }
```

### Améliorer la compatibilité avec les anciens navigateurs

Le mot-clé `only` empêche les navigateurs qui ne prennent pas en charge les requêtes média avec les caractéristiques média d'appliquer les styles concernés. Cet opérateur n'a aucun effet pour les navigateurs modernes\*.\*


```css
@media only screen and (color) { ... }
```

Améliorations syntaxiques avec la spécification de niveau 4
-----------------------------------------------------------

La spécification de niveau 4 pour les requêtes média ajoute des améliorations syntaxiques pour les requêtes média qui portent sur un intervalle (par exemple les critères de largeur et de hauteur). On peut par exemple utiliser le préfixe `max-` pour les largeurs et écrire :


```css
@media (max-width: 30em) { ... }
```


Avec les requêtes média de niveau 4, on peut écrire :


```css
@media (width <= 30em) { ... }
```


Si on utilise `min-` et `max-` conjointement, on peut tester l'appartenance d'une valeur à un intervalle :


```css
@media (min-width: 30em) and (max-width: 50em) { ... }
```


Avec les requêtes média de niveau 4, on peut écrire :


```css
@media (30em <= width <= 50em ) { ... }
```


Les requêtes média de niveau 4 permettent également d'utiliser une logique booléenne avec les opérateurs `and`, `not` et `or`.

### Tester l'absence d'une caractéristique avec `not`

On peut utiliser l'opérateur `not()` autour d'une caractéristique média afin de tester l'absence de cette caractéristique. Ainsi, on peut `not(hover)` pour cibler les appareils qui ne permettent pas le survol d'un élément :


```css
@media (not(hover)) { ... }
```

### Tester plusieurs caractéristiques avec `or`

Il est possible d'utiliser l'opérateur `or` pour tester une correspondance sur plus d'une caractéristique. Dans l'exemple suivant, on cible les appareils qui ont un affichage monochrome (`not (color)`) ou qui permettent de survoler les éléments (`hover`) :


```css
@media (not (color)) or (hover) { ... }
```

Voir aussi
----------

* Tester des requêtes média en script
* Utiliser les animations CSS entre les requêtes média (en anglais)
* Les caractéristiques média spécifiques à Mozilla
* Les caractéristiques média spécifiques à WebKit