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

CKTIS / CSS

scroll-margin-block — marge de défilement logique

scroll-margin-block définit les marges au début et à la fin de l’axe de bloc autour d’une cible de défilement, sans modifier la mise en page des éléments.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate

Syntaxe

scroll-margin-block: <length>{1,2};

scroll-margin-block est une propriété raccourcie pour scroll-margin-block-start et scroll-margin-block-end. Une longueur définit les deux côtés ; deux longueurs définissent d’abord le début, puis la fin. Les deux valeurs sont initialement 0 ; la propriété n’est pas héritée. Les pourcentages et auto ne sont pas valides ; les longueurs négatives sont autorisées.

La direction de l’axe dépend de writing-mode : avec horizontal-tb, il s’agit du haut et du bas. La propriété modifie la zone utilisée pour l’accrochage et pour faire défiler une cible jusqu’à la zone visible, et non l’espacement de mise en page comme le fait margin. Contrairement à scroll-padding-block, elle s’applique à la cible, et non au conteneur.

L’exemple utilise scrollIntoView() sans accrochage. L’alignement start utilise 24px ; 8px concerne la fin. Un clic sur le bouton affiche scrollTop: 216.

Exemples

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