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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
---
title: top
slug: Web/CSS/top
tags:
- CSS
- Positionnement
- Propriété
- Reference
translation_of: Web/CSS/top
---
{{CSSRef}}
La propriété **`top`** définit une partie de la position des éléments positionnés, elle n'a aucun effet pour les éléments non-positionnés.
{{EmbedInteractiveExample("pages/css/top.html")}}
L'effet de la propriété `top` dépend de la façon dont l'élément est positionné (autrement dit, il dépend de la valeur de la propriété {{cssxref("position")}}) :
- Pour les éléments qui sont positionnés de manière absolue ({{cssxref("position")}}`: absolute` ou {{cssxref("position")}}`: fixed`), cette propriété définit la distance entre le bord haut de la marge (_margin_) de l'élément et le bord haut du bloc englobant (il faut que le bloc englobant ait `position: relative`).
- Lorsque `position` vaut `relative`, cela définit la grandeur du déplacement avec laquelle l'élément est placé en dessous de sa position normale.
- Lorsque `position` vaut `sticky`, la propriété `top` se comporte comme avec `relative` lorsque l'élément se situe à l'intérieur de la zone d'affichage (_viewport_) et elle se comporte comme `fixed` lorsque l'élément est à l'extérieur de la zone d'affichage.
- Lorsque `position` vaut `static`, la propriété `top` n'a aucun effet.
Lorsque `top` et {{cssxref("bottom")}} sont utilisés tous les deux, tant que {{cssxref("height")}} n'est pas définie ou ne vaut pas `auto` ou `100%`, les distances introduites par `top` et {{cssxref("bottom")}} seront respectées. Sinon, si {{cssxref("height")}} est contrainte d'une certaine façon, la propriété `top` prendra le pas sur {{cssxref("bottom")}} qui sera ignorée.
## Syntaxe
```css
/* Valeur de longueur */
/* Type <length> */
top: 3px;
top: 2.4em;
/* Valeur en pourcentages */
/* Relative à la hauteur du bloc englobant */
/* Type <percentages> */
top: 10%;
/* Avec un mot-clé */
top: auto;
/* Valeur globale */
top: inherit;
top: initial;
top: unset;
```
### Valeurs
- `<length>`
- : Une valeur négative, nulle ou positive du type {{cssxref("<length>")}} qui représente :
- La distance depuis le bord haut du bloc englobant pour les _éléments positionnés de façon absolue_
- Le décalage avec lequel l'élément est déplacé vers le bas (relativement à sa position normale) pour _les éléments positionnés de façon relative_.
- `<percentage>`
- : Une valeur du type {{cssxref("<percentage>")}} qui est relative à la hauteur du bloc englobant.
- `auto`
- : Un mot-clé qui représente :
- Pour les éléments positionnés de façon absolue, la position de l'élément en fonction de la propriété {{cssxref("bottom")}} et qui traite `height: auto` comme une hauteur basée sur le contenu. Si `bottom`vaut également `auto`, l'élément est positionné verticalement comme s'il avait été un élément statique.
- Pour les éléments positionnés de façon relative, le décalage de l'élément par rapport à sa position originale, basée sur la propriété {{cssxref("bottom")}}. Si `bottom` vaut également `auto`, aucun décalage n'est appliqué.
### Syntaxe formelle
{{csssyntax}}
## Exemples
### Positionnement relatif
#### HTML
```html
<div>
<p>Lorem ipsum et tralala normal</p>
<p class="relatif">Lorem ipsum et tralala relatif</p>
<p>Lorem ipsum et tralala normal</p>
</div>
```
#### CSS
```css
div {
border: 2px black dashed;
}
p.relatif {
position: relative;
top: 5em;
border: 2px black solid
}
```
#### Résultat
{{EmbedLiveSample("Positionnement_relatif","100%","200")}}
### Positionnement absolu
#### HTML
```html
<div>
<p>Lorem ipsum et tralala normal</p>
<p class="absolu">Lorem ipsum et tralala absolu</p>
<p>Lorem ipsum et tralala normal</p>
</div>
```
#### CSS
```css
div {
border: 2px black dashed;
}
p.absolu {
position: absolute;
top: 5em;
border: 2px black solid;
}
```
#### Résultat
{{EmbedLiveSample("Positionnement_absolu","100%","100%")}}
## Spécifications
| Spécification | État | Commentaires |
| ---------------------------------------------------------------------------- | ---------------------------------------- | ---------------------------------------------------------------------- |
| {{SpecName('CSS3 Transitions', '#animatable-css', 'top')}} | {{Spec2('CSS3 Transitions')}} | `top` peut désormais être animée. |
| {{SpecName('CSS3 Positioning', '#propdef-top', 'top')}} | {{Spec2('CSS3 Positioning')}} | Description du comportement pour le positionnement adhérent (_sticky_) |
| {{SpecName('CSS2.1', 'visuren.html#propdef-top', 'top')}} | {{Spec2('CSS2.1')}} | Définition initiale. |
{{cssinfo}}
## Compatibilité des navigateurs
{{Compat("css.properties.top")}}
## Voir aussi
- {{cssxref("position")}}
- {{cssxref("bottom")}}
- {{cssxref("height")}}
- {{cssxref("left")}}
- {{cssxref("right")}}
- [Les bases de CSS : la disposition et le positionnement](/fr/Apprendre/CSS/Les_bases/La_disposition#Le_positionnement)
|
