Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

scrollbar-width — tloušťka posuvníků

Vlastnost scrollbar-width určuje požadovanou tloušťku posuvníků kontejneru. Přijímá hodnoty auto, thin nebo none; nenastavuje rozměr v pixelech ani sama o sobě nezapíná posouvání.

Verze: 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 se vztahuje na kontejnery s posouváním. auto používá výchozí tloušťku, thin požaduje tenčí, ale stále použitelné posuvníky a none posuvníky skryje, aniž by jinak vypnula posouvání. Délkové hodnoty ani procenta nejsou povoleny; dostupná jsou také globální klíčová slova CSS.

Počáteční hodnota je auto. Vlastnost se nedědí; její vypočtenou hodnotou je zadané klíčové slovo a animace je diskrétní. Hodnota na kořenovém prvku (html) se použije pro zobrazovanou oblast; hodnota na body se tam nepřenáší.

Kvůli omezením platformy nebo uživatelským preferencím může thin vypadat jako auto. Nepředpokládejte konkrétní tloušťku ani trvale viditelný posuvník. Tenčí posuvníky používejte v těsných prostorech, ne pouze jako dekoraci. Při hodnotě none poskytněte vizuální náznak, že lze obsah posouvat, a alternativní ovládání posouvání, a to i pro uživatele myši bez kolečka.

Jiná hodnota než auto způsobí, že se ignorují nestandardní mechanismy stylování posuvníků, například rodina ::-webkit-scrollbar. Příklad používá overflow: auto pro práci s přetékajícím obsahem a scrollbar-width: thin pouze k vyžádání požadované tloušťky posuvníků.

Příklady

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

Výsledek

Computed scrollbar-width: thin
Can scroll vertically: true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje