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.