Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

top — décalage supérieur

La propriété top définit le décalage supérieur d’un élément positionné. Son sens dépend de position ; elle n’a aucun effet avec static.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

top: auto | <length-percentage>;

For an absolutely positioned element (including `position: fixed`), the `<length-percentage>` value can use `anchor()` or `anchor-size()`, subject to the rules of CSS Anchor Positioning.

top se rapporte au bord supérieur physique. Cette propriété n’est pas héritée ; sa valeur initiale auto ne signifie pas simplement zéro. Les longueurs, les pourcentages et les valeurs négatives sont autorisés.

Avec relative, elle déplace l’élément par rapport à sa position d’origine, tout en conservant l’espace qu’il occupe. Avec absolute et fixed, elle définit un décalage par rapport au bloc conteneur ; avec fixed, il s’agit généralement de la fenêtre d’affichage, mais pas toujours.

Avec sticky, elle définit un seuil supérieur par rapport au plus proche port de défilement, dans les limites du bloc conteneur. Les pourcentages se rapportent à la hauteur du bloc conteneur ou, avec sticky, à celle du port de défilement.

Dans l’exemple, top: 25% donne 30px, car le conteneur mesure 120px de haut. Avec position: static, la propriété n’a aucun effet.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>top</title>
<style>
  .container {
    position: relative;
    width: 200px;
    height: 120px;
    background: #eee;
  }
  .box {
    position: absolute;
    top: 25%;
    left: 0;
    width: 40px;
    height: 40px;
    margin: 0;
    background: #1565c0;
  }
</style>
<div class="container"><div class="box"></div></div>

Résultat

box top − container top = 30 CSS px

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources