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

CKTIS / CSS

scroll-padding-block — décaler la zone cible du défilement

scroll-padding-block définit les décalages de la zone d’affichage optimale au début et à la fin de l’axe de bloc d’un conteneur défilant, 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-padding-block: [ auto | <length-percentage [0,∞]> ]{1,2};

scroll-padding-block est une propriété raccourcie pour scroll-padding-block-start et scroll-padding-block-end. Une valeur définit les deux côtés ; deux valeurs indiquent d’abord le début, puis la fin. Appliquez-la au conteneur défilant.

Les valeurs admises sont les longueurs non négatives, les pourcentages et auto (la valeur initiale, déterminée par le navigateur). Les pourcentages se rapportent à la dimension correspondante de la zone de défilement. Cette propriété n’est pas héritée.

Les côtés dépendent de writing-mode : avec horizontal-tb, il s’agit du haut et du bas ; avec vertical-rl, de la droite et de la gauche. Ne supposez pas que l’axe de bloc est toujours vertical.

Ces décalages ne créent pas d’espace comme padding et ne modifient pas la disposition. Ils influent sur la zone cible du défilement ; avec le défilement par points d’accrochage, ils définissent les bords du snapport. Il n’est pas nécessaire d’activer ce mécanisme.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>scroll-padding-block</title>
<style>
  #scroller {
    writing-mode: horizontal-tb;
    height: 160px;
    width: 240px;
    overflow: auto;
    scroll-padding-block: 24px 12px;
    border: 1px solid;
  }
  .space { height: 240px; }
  #target { height: 40px; background: lightblue; }
</style>
<div id="scroller">
  <div class="space"></div>
  <div id="target">Target</div>
  <div class="space"></div>
</div>
<pre id="result"></pre>
<script>
  const scroller = document.getElementById('scroller');
  const target = document.getElementById('target');
  target.scrollIntoView({ block: 'start', behavior: 'instant' });
  document.getElementById('result').textContent =
    `scrollTop: ${scroller.scrollTop}`;
</script>

Résultat

scrollTop: 216

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