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.