Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

scrollbar-width — spessore delle barre di scorrimento

La proprietà scrollbar-width specifica lo spessore desiderato delle barre di scorrimento di un contenitore. Accetta auto, thin o none; non imposta una dimensione in pixel né attiva da sola lo scorrimento.

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

Sintassi

scrollbar-width: auto | thin | none;

scrollbar-width si applica ai contenitori scorrevoli. auto usa lo spessore predefinito, thin richiede barre più sottili ma comunque utilizzabili e none nasconde le barre senza disattivare lo scorrimento in altri modi. Le lunghezze e le percentuali non sono consentite; sono disponibili anche le parole chiave globali CSS.

Il valore iniziale è auto. La proprietà non è ereditata; il suo valore calcolato è la parola chiave specificata e l’animazione è discreta. Un valore sull’elemento radice (html) si applica alla finestra; un valore su body non viene propagato a essa.

A causa dei vincoli della piattaforma o delle preferenze dell’utente, thin può apparire come auto. Non dare per scontati uno spessore specifico o una barra sempre visibile. Usa barre più sottili negli spazi ristretti, non solo per decorazione. Con none, fornisci un’indicazione visiva che suggerisca lo scorrimento e controlli alternativi per scorrere, anche per chi usa un mouse senza rotellina.

Un valore diverso da auto fa sì che vengano ignorati i meccanismi non standard per lo stile delle barre di scorrimento, come la famiglia ::-webkit-scrollbar. L’esempio usa overflow: auto per gestire i contenuti in eccesso e scrollbar-width: thin solo per richiedere lo spessore delle barre.

Esempi

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

Risultato

Computed scrollbar-width: thin
Can scroll vertically: true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti