Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes