CKTIS / CSS
scrollbar-width — espessura das barras de deslocamento
A propriedade scrollbar-width especifica a espessura pretendida das barras de deslocamento de um contentor. Aceita auto, thin ou none; não define uma dimensão em píxeis nem ativa, por si só, o deslocamento.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
scrollbar-width: auto | thin | none;scrollbar-width aplica-se a contentores com deslocamento. auto utiliza a espessura predefinida, thin pede barras mais finas mas ainda utilizáveis, e none oculta as barras sem desativar o deslocamento por outros meios. Não são permitidos comprimentos nem percentagens; também estão disponíveis as palavras-chave globais de CSS.
O valor inicial é auto. A propriedade não é herdada; o seu valor calculado é a palavra-chave especificada e a animação é discreta. Um valor no elemento raiz (html) aplica-se à janela de visualização; um valor em body não é propagado para essa área.
Devido às limitações da plataforma ou às preferências do utilizador, thin pode ter o mesmo aspeto que auto. Não pressuponha uma espessura específica nem uma barra sempre visível. Utilize barras mais finas em espaços apertados, e não apenas como decoração. Com none, forneça uma indicação visual de que é possível deslocar o conteúdo e controlos alternativos para o fazer, também para quem utiliza um rato sem roda.
Um valor diferente de auto faz com que sejam ignorados os mecanismos não normalizados de estilo das barras de deslocamento, como a família ::-webkit-scrollbar. O exemplo utiliza overflow: auto para lidar com conteúdo excedente e scrollbar-width: thin apenas para pedir a espessura pretendida das barras.
Exemplos
<!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>Resultado
Computed scrollbar-width: thin Can scroll vertically: true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.