blob: f779767aaea987bd1c629958ba107ee8fb64b2e5 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
---
title: '@viewport'
slug: Web/CSS/@viewport
translation_of: Web/CSS/@viewport
browser-compat: css.at-rules.viewport
---
{{CSSRef}}{{deprecated_header}}
> **Note :** Voir <https://github.com/w3c/csswg-drafts/issues/4766> quant à la discussion pour le retrait de @viewport des standards.
La [règle @](fr/docs/Web/CSS/At-rule) **`@viewport`** permet de configurer la zone d'affichage (le _viewport_ en anglais) à travers laquelle le document est affiché. Cette règle est principalement utilisée pour les appareils mobiles mais aussi pour les navigateurs de bureau (par exemple, Microsoft Edge qui gère la division de l'écran).
Les longueurs exprimées en pourcentages sont calculées de façon relative à la **zone d'affichage initiale** c'est-à-dire le _viewport_ avant tout ajustement effectué par le navigateur ou par les styles de la page. Généralement, cela correspond à la taille de la fenêtre pour les navigateurs de bureau lorsqu'ils ne sont pas utilisés en mode plein écran.
Pour les appareils mobiles (ou pour les appareils de bureau qui sont en plein écran), la zone d'affichage initiale correspond à la portion de l'écran disponible pour l'application. Cela peut correspondre à l'écran entier ou bien à l'écran auquel on enlève les zones contrôlées par le système d'exploitation (par exemple la barre de tâche) ou bien encore à la zone de l'écran qui n'est pas occupée par le système d'exploitation ou d'autres applications.
```css
@viewport {
width: device-width;
}
```
## Syntaxe
Cette règle @ contient un ensemble de descripteurs CSS dans un bloc délimité par des accolades.
Un facteur de zoom de `1.0` ou de `100%` signifie qu'il n'y a eu aucun zoom. Si la valeur est supérieure, cela signifie qu'on a zoomé pour agrandir le contenu. Inversement, si la valeur est inférieure à `1.0` ou à `100%`, cela signifie qu'on a dézoomé.
### Descripteurs
Les navigateurs sont supposés ignorer les descripteurs non reconnus.
- `min-width`
- : Ce descripteur détermine la largeur minimale de la zone d'affichage (_viewport_) lorsque le document est affiché initialement.
- `max-width`
- : Ce descripteur détermine la largeur maximale de la zone d'affichage (_viewport_) lorsque le document est affiché initialement.
- `width`
- : Ce descripteur est un raccourci qui permet de définir `min-width` et `max-width`.
- `min-height`
- : Ce descripteur détermine la hauteur minimale de la zone d'affichage (_viewport_) lorsque le document est affiché initialement.
- `max-height`
- : Ce descripteur détermine la hauteur maximale de la zone d'affichage (_viewport_) lorsque le document est affiché initialement.
- `height`
- : Ce descripteur est un raccourci qui permet de définir `min-height` et `max-height`.
- `zoom`
- : Ce descripteur permet de définir le niveau de zoom initial.
- `min-zoom`
- : Ce descripteur permet de définir le niveau de zoom minimal.
- `max-zoom`
- : Ce descripteur permet de définir le niveau de zoom maximal.
- `user-zoom`
- : Ce descripteur indique si l'utilisateur peut, ou non, changer le niveau de zoom.
- `orientation`
- : Ce descripteur contrôle l'orientation du document.
- `viewport-fit`
- : Ce descripteur contrôle l'affichage du document pour les affichages non-rectangulaires.
### Syntaxe formelle
{{csssyntax}}
## Exemples
```css
@viewport {
min-width: 640px;
max-width: 800px;
}
@viewport {
zoom: 0.75;
min-zoom: 0.5;
max-zoom: 0.9;
}
@viewport {
orientation: landscape;
}
```
## Spécifications
{{Specifications}}
## Compatibilité des navigateurs
{{Compat}}
## Voir aussi
- [`<meta>`](/fr/docs/Web/HTML/Element/meta) et plus précisément `<meta name="viewport">`
- [Utiliser la balise `meta` afin de contrôler la disposition sur les navigateurs mobiles](/fr/docs/Web/HTML/Viewport_meta_tag)
|
