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

CKTIS / CSS

scroll-margin-block-start — décaler une cible de défilement au début du bloc

scroll-margin-block-start définit un décalage pour la zone d’une cible de défilement du côté du début du bloc. La propriété ne crée pas d’espace dans la mise en page ; le côté physique concerné dépend de writing-mode.

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

Syntaxe

scroll-margin-block-start: <length>;

scroll-margin-block-start modifie la zone d’accrochage au défilement d’un élément du côté du début du bloc. Avec horizontal-tb, il s’agit du haut ; avec vertical-rl, de la droite. Contrairement à margin, cette propriété n’écarte pas les éléments dans la mise en page.

La propriété accepte une <length>, y compris une longueur négative, mais ni les pourcentages ni auto. Sa valeur initiale est 0 et elle n’est pas héritée. Définissez-la sur l’élément cible, tandis que scroll-padding-block-start s’applique au conteneur de défilement.

Cette zone devrait être prise en compte lors de la navigation par fragment et par scrollIntoView(), même si l’accrochage au défilement n’est pas activé. La plage de défilement disponible limite l’écart qu’il est possible d’obtenir.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>scroll-margin-block-start</title>
<style>
  #scroller {
    height: 160px;
    overflow: auto;
    writing-mode: horizontal-tb;
  }
  .space { height: 240px; }
  #target {
    height: 40px;
    scroll-margin-block-start: 24px;
    background: gold;
  }
</style>
<button id="go">Scroll</button>
<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');
  document.getElementById('go').onclick = () => {
    target.scrollIntoView({ block: 'start', behavior: 'instant' });
    document.getElementById('result').textContent =
      `scrollTop: ${scroller.scrollTop}`;
  };
</script>

Résultat

scrollTop: 216

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