WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

scrollbar-width — Bildlaufleistenbreite

Die Eigenschaft scrollbar-width legt die gewünschte Breite der Bildlaufleisten eines Containers fest. Sie akzeptiert auto, thin oder none; sie legt weder ein Pixelmaß fest noch aktiviert sie selbst das Scrollen.

Version: 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 gilt für Scrollcontainer. auto verwendet die standardmäßige Breite, thin fordert dünnere, aber weiterhin brauchbare Bildlaufleisten an, und none blendet Bildlaufleisten aus, ohne das Scrollen auf andere Weise zu deaktivieren. Längen und Prozentwerte sind nicht zulässig; CSS-weite Schlüsselwörter sind ebenfalls verfügbar.

Der Anfangswert ist auto. Die Eigenschaft wird nicht vererbt; ihr berechneter Wert ist das angegebene Schlüsselwort, und die Animation erfolgt diskret. Ein Wert auf dem Wurzelelement (html) gilt für den Viewport; ein Wert auf body wird nicht dorthin übertragen.

Wegen Plattformbeschränkungen oder Benutzereinstellungen kann thin wie auto aussehen. Gehe nicht von einer bestimmten Breite oder einer dauerhaft sichtbaren Bildlaufleiste aus. Verwende dünnere Bildlaufleisten für beengte Bereiche, nicht nur zur Dekoration. Bei none solltest du einen visuellen Hinweis auf das Scrollen und alternative Steuerelemente dafür bereitstellen, auch für Mausbenutzer ohne Mausrad.

Ein anderer Wert als auto bewirkt, dass nicht standardisierte Mechanismen zur Gestaltung von Bildlaufleisten, etwa die ::-webkit-scrollbar-Familie, ignoriert werden. Das Beispiel verwendet overflow: auto, um überlaufende Inhalte zu behandeln, und scrollbar-width: thin ausschließlich, um die gewünschte Breite der Bildlaufleisten anzufordern.

Beispiele

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

Ergebnis

Computed scrollbar-width: thin
Can scroll vertically: true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen