Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

scrollbar-width — grubość pasków przewijania

Właściwość scrollbar-width określa pożądaną grubość pasków przewijania kontenera. Przyjmuje auto, thin lub none; nie ustawia wymiaru w pikselach ani sama nie włącza przewijania.

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

Składnia

scrollbar-width: auto | thin | none;

scrollbar-width dotyczy kontenerów przewijania. auto oznacza domyślną grubość, thin prosi o cieńsze, nadal użyteczne paski, a none ukrywa paski bez wyłączania przewijania innymi sposobami. Wartości długości i procenty nie są dozwolone; dostępne są też globalne słowa kluczowe CSS.

Wartość początkowa to auto. Właściwość nie jest dziedziczona; wartość obliczona jest podanym słowem kluczowym, a animacja jest dyskretna. Wartość ustawiona na elemencie głównym (html) jest stosowana do obszaru widoku; ustawienie na body nie jest do niego przenoszone.

thin może wyglądać jak auto ze względu na platformę lub preferencje użytkownika. Nie zakładaj konkretnej grubości ani stałej widoczności paska. Używaj cieńszych pasków w ciasnych obszarach, nie tylko dla ozdoby. Przy none zapewnij wskazówkę wizualną i alternatywną obsługę przewijania, także dla osób używających myszy bez kółka.

Wartość inna niż auto powoduje pominięcie niestandardowych mechanizmów stylowania pasków, takich jak rodzina ::-webkit-scrollbar. Przykład używa overflow: auto do obsługi nadmiarowej zawartości, a scrollbar-width: thin wyłącznie do określenia pożądanej grubości pasków.

Przykłady

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

Wynik

Computed scrollbar-width: thin
Can scroll vertically: true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła