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

CKTIS / CSS

scroll-margin-inline — marges de défilement logiques

Cette propriété raccourcie définit les marges de la zone cible au début et à la fin de l’axe inline, sans modifier la disposition des éléments.

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

Syntaxe

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

scroll-margin-inline définit scroll-margin-inline-start et scroll-margin-inline-end sur l’élément cible. Une longueur s’applique aux deux côtés ; deux longueurs indiquent d’abord le début, puis la fin. La valeur initiale est 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.

Les côtés logiques dépendent de writing-mode et de direction : ils ne correspondent pas toujours à gauche et à droite. Les marges modifient la zone de magnétisme et de défilement vers l’élément, pas sa taille ni son espacement dans la disposition. En revanche, scroll-padding-inline agit sur le conteneur de défilement.

La propriété n’active pas elle-même le magnétisme : utilisez scroll-snap-type et scroll-snap-align pour cela. Elle peut aussi influencer le défilement vers un élément sans magnétisme. Les limites de défilement peuvent empêcher la prise en compte de toute la marge.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>scroll-margin-inline: inline snap offsets</title>
  <style>
    #track {
      display: flex;
      width: 300px;
      overflow-x: auto;
      writing-mode: horizontal-tb;
      direction: ltr;
      scroll-snap-type: x mandatory;
    }
    #track > div {
      flex: 0 0 200px;
      height: 80px;
      margin: 0;
      scroll-snap-align: start;
      background: lightblue;
    }
    #track > #target {
      scroll-margin-inline: 20px 40px;
      background: coral;
    }
  </style>
</head>
<body>
  <div id="track" role="region" aria-label="Scrollable cards" tabindex="0">
    <div>Card A</div><div id="target">Card B</div><div>Card C</div>
  </div>
  <script>
    const track = document.getElementById('track');
    const target = document.getElementById('target');
    const style = getComputedStyle(target);
    target.scrollIntoView({ behavior: 'instant', block: 'nearest', inline: 'start' });
    const card = target.getBoundingClientRect();
    const inset = card.left - track.getBoundingClientRect().left;
    console.log(`Computed inline scroll margins: ${style.scrollMarginInlineStart} / ${style.scrollMarginInlineEnd}`);
    console.log(`Card width: ${card.width}px; card start inset: ${inset}px`);
  </script>
</body>
</html>

Résultat

Computed inline scroll margins: 20px / 40px
Card width: 200px; card start inset: 20px

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