KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

scrollbar-width — dikte van schuifbalken

De eigenschap scrollbar-width bepaalt de gewenste dikte van de schuifbalken van een container. De waarden zijn auto, thin of none; de eigenschap stelt geen afmeting in pixels in en schakelt scrollen niet zelf in.

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

Syntax

scrollbar-width: auto | thin | none;

scrollbar-width geldt voor scrollcontainers. auto gebruikt de standaarddikte, thin vraagt om dunnere maar nog steeds bruikbare schuifbalken, en none verbergt schuifbalken zonder scrollen op andere manieren uit te schakelen. Lengtes en percentages zijn niet toegestaan; CSS-brede sleutelwoorden zijn ook beschikbaar.

De beginwaarde is auto. De eigenschap wordt niet overgeërfd; de berekende waarde is het opgegeven sleutelwoord en de animatie is discreet. Een waarde op het root-element (html) geldt voor de viewport; een waarde op body wordt daar niet naartoe doorgegeven.

Door beperkingen van het platform of voorkeuren van de gebruiker kan thin eruitzien als auto. Ga niet uit van een bepaalde dikte of een permanent zichtbare schuifbalk. Gebruik dunnere schuifbalken in krappe ruimtes, niet alleen als versiering. Zorg bij none voor een visuele aanwijzing dat er gescrold kan worden en voor alternatieve bediening, ook voor muisgebruikers zonder wiel.

Een andere waarde dan auto zorgt ervoor dat niet-standaardmechanismen voor het opmaken van schuifbalken, zoals de ::-webkit-scrollbar-familie, worden genegeerd. Het voorbeeld gebruikt overflow: auto voor overlopende inhoud en scrollbar-width: thin uitsluitend om de gewenste dikte van de schuifbalken aan te vragen.

Voorbeelden

<!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>

Resultaat

Computed scrollbar-width: thin
Can scroll vertically: true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen