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

CKTIS / CSS

scrollbar-width — épaisseur des barres de défilement

La propriété scrollbar-width définit l’épaisseur souhaitée des barres de défilement d’un conteneur. Elle accepte auto, thin ou none ; elle ne définit pas une dimension en pixels et n’active pas le défilement à elle seule.

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

Syntaxe

scrollbar-width: auto | thin | none;

scrollbar-width s’applique aux conteneurs défilants. auto utilise l’épaisseur par défaut, thin demande des barres plus fines mais toujours utilisables, et none masque les barres sans désactiver le défilement par d’autres moyens. Les longueurs et les pourcentages ne sont pas autorisés ; les mots-clés CSS globaux sont également disponibles.

La valeur initiale est auto. La propriété n’est pas héritée ; sa valeur calculée est le mot-clé spécifié et son animation est discrète. Une valeur définie sur l’élément racine (html) s’applique à la fenêtre d’affichage ; une valeur définie sur body n’y est pas propagée.

En raison des contraintes de la plateforme ou des préférences de l’utilisateur, thin peut ressembler à auto. Ne présumez ni d’une épaisseur particulière ni d’une barre de défilement toujours visible. Utilisez des barres plus fines dans les espaces restreints, et pas uniquement à des fins décoratives. Avec none, fournissez un indice visuel indiquant que le contenu peut défiler ainsi que d’autres commandes de défilement, notamment pour les personnes qui utilisent une souris sans molette.

Une valeur autre que auto entraîne l’ignorance des mécanismes non standard de style des barres de défilement, comme la famille ::-webkit-scrollbar. L’exemple utilise overflow: auto pour gérer le contenu qui déborde et scrollbar-width: thin uniquement pour demander l’épaisseur souhaitée des barres de défilement.

Exemples

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Request a thin scrollbar</title>
<style>
  #panel {
    box-sizing: border-box;
    width: 240px;
    height: 100px;
    overflow: auto;
    scrollbar-width: thin;
    border: 1px solid;
  }
  .content { min-height: 300px; }
</style>
</head>
<body>
<div id="panel" tabindex="0" role="region" aria-label="Vertical scrolling example">
  <div class="content">This content is taller than the panel.</div>
</div>
<script>
  const panel = document.getElementById('panel');
  console.log(`Computed scrollbar-width: ${getComputedStyle(panel).scrollbarWidth}`);
  panel.scrollTop = 20;
  console.log(`Can scroll vertically: ${panel.scrollTop > 0}`);
  panel.scrollTop = 0;
</script>
</body>
</html>

Résultat

Computed scrollbar-width: thin
Can scroll vertically: true

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