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

CKTIS / CSS

scroll-margin-top — décalage supérieur pour le défilement

scroll-margin-top définit le débord supérieur de la zone d’un élément utilisée pour le faire défiler jusqu’à la vue et pour l’accrochage au défilement. Cette propriété ne crée pas d’espace dans la mise en page.

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

Syntaxe

scroll-margin-top: <length>;

scroll-margin-top étend vers le haut la zone d’accrochage au défilement d’un élément. Elle concerne le haut physique ; scroll-margin-block-start concerne le début de l’axe de bloc, selon le mode d’écriture.

La propriété accepte une <length>, y compris une valeur négative, mais pas de pourcentage ni auto. Sa valeur initiale est 0 ; elle n’est pas héritée et s’applique à tous les éléments.

Définissez-la sur la cible du défilement, par exemple pour laisser de la place sous un en-tête fixe. Contrairement à margin-top, elle ne modifie pas la mise en page. scroll-padding-top définit le décalage du côté du conteneur. La zone est prise en compte lors du défilement vers une cible même sans accrochage activé ; les limites de défilement peuvent réduire l’espace obtenu.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>scroll-margin-top</title>
<style>
  #scroller { height: 120px; overflow: auto; scroll-behavior: auto; }
  .space { height: 200px; }
  #target { height: 40px; scroll-margin-top: 24px; background: gold; }
</style>
<div id="scroller">
  <div class="space"></div>
  <div id="target">Target</div>
  <div class="space"></div>
</div>
<output id="result"></output>
<script>
  const scroller = document.getElementById('scroller');
  const target = document.getElementById('target');
  target.scrollIntoView({ block: 'start', behavior: 'instant' });
  document.getElementById('result').textContent = scroller.scrollTop;
</script>

Résultat

176

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