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

CKTIS / CSS

scroll-margin-inline-start — décalage de défilement logique

scroll-margin-inline-start définit un décalage de la zone cible de défilement d’un élément du côté inline-start. Il ne crée pas d’espace dans la mise en page, et le côté physique correspondant dépend du sens d’écriture.

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

Syntaxe

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

scroll-margin-inline-start décale le bord inline-start de la zone d’accrochage au défilement d’un élément. Cette propriété agit aussi lorsque l’on fait défiler jusqu’à l’élément sans que l’accrochage soit activé. Contrairement à margin-inline-start, elle ne modifie pas la mise en page ; en revanche, scroll-padding-inline-start se définit sur le conteneur de défilement.

Elle accepte une <length>, y compris des valeurs négatives, mais ni les pourcentages ni auto. Sa valeur initiale est 0 et elle n’est pas héritée. Une valeur positive étend la zone cible de ce côté.

Il s’agit d’une direction logique, et non d’un bord gauche fixe : avec writing-mode: horizontal-tb, inline-start est à gauche pour direction: ltr et à droite pour direction: rtl. Un mode d’écriture vertical modifie la correspondance des axes.

Dans l’exemple, un clic sur Scroll to B devrait laisser 24 CSS px avant B, sans modifier la disposition des éléments. La valeur attendue de scrollLeft est 176. La plage de défilement disponible peut limiter l’alignement demandé, en particulier près des extrémités du contenu.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>scroll-margin-inline-start</title>
<style>
  .scroller {
    display: flex;
    width: 240px;
    overflow-x: auto;
    direction: ltr;
    writing-mode: horizontal-tb;
  }
  .item {
    flex: 0 0 200px;
    height: 80px;
    background: #ddd;
  }
  #target {
    scroll-margin-inline-start: 24px;
    background: #9df;
  }
</style>
<button id="go">Scroll to B</button>
<div class="scroller">
  <div class="item">A</div>
  <div class="item" id="target">B</div>
  <div class="item">C</div>
</div>
<script>
  document.getElementById('go').addEventListener('click', () => {
    document.getElementById('target').scrollIntoView({
      behavior: 'instant', block: 'nearest', inline: 'start'
    });
  });
</script>

Résultat

After clicking “Scroll to B”: scroller.scrollLeft = 176; B starts 24 CSS px inside the scroller's left edge.

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