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

CKTIS / CSS

scroll-margin-left — espace à gauche lors du défilement vers un élément

scroll-margin-left décale le bord gauche de la zone utilisée pour aligner un élément pendant le défilement. Cette propriété ne crée pas une marge de mise en page ordinaire ; elle permet de laisser de l’espace à gauche de la cible.

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

Syntaxe

scroll-margin-left: <length>;
/* Examples */
scroll-margin-left: 24px;
scroll-margin-left: -8px;
scroll-margin-left: 0;

Une valeur positive de scroll-margin-left étend vers la gauche la zone d’accrochage au défilement d’un élément ; une valeur négative déplace le bord gauche de cette zone vers l’intérieur. Cette zone part du rectangle englobant de sa boîte de bordure transformée. Contrairement à margin-left, cette propriété ne modifie pas la mise en page.

Elle accepte une <length>, y compris des valeurs négatives, mais ni les pourcentages ni auto. Sa valeur initiale est 0 ; elle n’est pas héritée. Elle concerne le côté gauche physique ; scroll-margin-inline-start dépend du sens d’écriture.

Définissez-la sur l’élément cible, et scroll-padding-left sur le conteneur de défilement. Elle s’applique aussi lors du défilement vers un fragment ou avec scrollIntoView(), même si l’accrochage n’est pas activé. Les limites de défilement peuvent réduire l’espace.

L’exemple aligne la cible à gauche en laissant 24px. Un test effectué avec Chromium 157.0.8103.51 dans un environnement isolé a confirmé le résultat attendu : scrollLeft=176; gap=24px.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>scroll-margin-left</title>
<style>
  #scroller {
    width: 300px;
    overflow-x: auto;
    direction: ltr;
    writing-mode: horizontal-tb;
  }
  .track { display: flex; width: 700px; }
  .before { flex: 0 0 200px; }
  #target {
    flex: 0 0 100px;
    height: 60px;
    background: lightblue;
    scroll-margin-left: 24px;
  }
  .after { flex: 0 0 400px; }
</style>
<div id="scroller">
  <div class="track">
    <div class="before"></div>
    <div id="target">Target</div>
    <div class="after"></div>
  </div>
</div>
<pre id="result"></pre>
<script>
  const scroller = document.getElementById('scroller');
  const target = document.getElementById('target');
  target.scrollIntoView({ behavior: 'instant', block: 'nearest', inline: 'start' });
  requestAnimationFrame(() => {
    const gap = target.getBoundingClientRect().left
      - scroller.getBoundingClientRect().left;
    document.getElementById('result').textContent =
      `scrollLeft=${scroller.scrollLeft}; gap=${gap}px`;
  });
</script>

Résultat

scrollLeft=176; gap=24px

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