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

CKTIS / CSS

scroll-padding-inline-start — retrait au début inline de la zone de défilement

scroll-padding-inline-start définit un retrait vers l’intérieur au bord inline-start de la zone de visualisation optimale d’un conteneur de défilement. Ce n’est pas un padding ordinaire ; le bord logique dépend du sens et du mode d’écriture.

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

Syntaxe

scroll-padding-inline-start: auto | <length-percentage [0,∞]>;

scroll-padding-inline-start définit un retrait pour la zone d’alignement du défilement du côté inline-start. La propriété s’applique à un conteneur de défilement, n’est pas héritée et n’ajoute pas d’espace à la mise en page comme le fait padding.

Avec writing-mode: horizontal-tb et direction: ltr, le début inline se trouve à gauche ; avec direction: rtl, il se trouve à droite. En mode d’écriture vertical, l’axe inline est vertical : il ne faut donc pas assimiler inline-start au côté gauche.

Les valeurs acceptées sont auto et des longueurs et pourcentages non négatifs. Un pourcentage se rapporte à la dimension correspondante de la zone de défilement visible. La valeur initiale auto laisse le choix au navigateur et signifie généralement 0px. Cette propriété n’active pas à elle seule l’accrochage ; utilisez scroll-snap-type pour cela.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>scroll-padding-inline-start: inset for scroll alignment</title>
  <style>
    #scroller {
      display: flex;
      width: 300px;
      overflow-x: auto;
      writing-mode: horizontal-tb;
      direction: ltr;
      scroll-snap-type: x mandatory;
      scroll-padding-inline-start: 40px;
    }
    .card {
      flex: 0 0 200px;
      height: 80px;
      scroll-snap-align: start;
      background: #dcecff;
      outline: 1px solid #345;
      outline-offset: -1px;
    }
  </style>
</head>
<body>
  <div id="scroller" role="region" aria-label="Scrollable cards" tabindex="0">
    <div class="card">Card A</div>
    <div class="card" id="target">Card B</div>
    <div class="card">Card C</div>
  </div>
  <script>
    const scroller = document.getElementById('scroller');
    const target = document.getElementById('target');
    target.scrollIntoView({ behavior: 'instant', block: 'nearest', inline: 'start' });
    const inset = target.getBoundingClientRect().left - scroller.getBoundingClientRect().left;
    const style = getComputedStyle(scroller);
    console.log(`Computed inline-start scroll padding: ${style.scrollPaddingInlineStart}; ordinary inline-start padding: ${style.paddingInlineStart}`);
    console.log(`Card start inset: ${inset}px; scrollLeft: ${scroller.scrollLeft}px`);
  </script>
</body>
</html>

Résultat

Computed inline-start scroll padding: 40px; ordinary inline-start padding: 0px
Card start inset: 40px; scrollLeft: 160px

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