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

CKTIS / CSS

scroll-margin — espacement lors du défilement vers un élément

scroll-margin définit des décalages autour d’un élément pris en compte lors du défilement jusqu’à celui-ci et de l’accrochage au défilement, sans modifier l’espacement de 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: <length>{1,4};

scroll-margin agrandit la zone d’accrochage à partir du rectangle englobant de la boîte de bordure transformée d’un élément. Contrairement à margin, cette propriété ne crée pas d’espacement dans la mise en page. Définissez-la sur l’élément cible ; scroll-padding s’applique au conteneur défilant.

Elle accepte de 1 à 4 longueurs : tous les côtés ; haut/bas et gauche/droite ; haut, gauche/droite, bas ; haut, droite, bas, gauche. Les valeurs négatives sont autorisées, mais pas les pourcentages ni auto. Sa valeur initiale est 0 et elle n’est pas héritée.

Elle agit aussi sur la navigation par fragment et sur scrollIntoView() lorsque l’accrochage au défilement n’est pas activé. Elle n’active pas l’accrochage à elle seule. Les limites de défilement peuvent empêcher de conserver l’espacement demandé.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>scroll-margin example</title>
<style>
  #scroller { height: 120px; overflow: auto; }
  .spacer { height: 200px; }
  #target { height: 40px; scroll-margin: 24px 0 0; background: gold; }
</style>
<button type="button" id="show">Show target</button>
<div id="scroller">
  <div class="spacer"></div>
  <div id="target">Target</div>
  <div class="spacer"></div>
</div>
<pre id="result"></pre>
<script>
  const scroller = document.getElementById('scroller');
  const target = document.getElementById('target');
  document.getElementById('show').addEventListener('click', () => {
    target.scrollIntoView({ block: 'start', behavior: 'instant' });
    document.getElementById('result').textContent =
      `scrollTop: ${scroller.scrollTop}`;
  });
</script>
</html>

Résultat

scrollTop: 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