Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

scrollbar-width — grosor de las barras de desplazamiento

La propiedad scrollbar-width especifica el grosor deseado de las barras de desplazamiento de un contenedor. Acepta auto, thin o none; no establece una dimensión en píxeles ni activa el desplazamiento por sí sola.

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

Sintaxis

scrollbar-width: auto | thin | none;

scrollbar-width se aplica a los contenedores de desplazamiento. auto usa el grosor predeterminado, thin solicita barras más finas pero que sigan siendo utilizables, y none oculta las barras sin desactivar el desplazamiento por otros medios. No se permiten longitudes ni porcentajes; también están disponibles las palabras clave globales de CSS.

El valor inicial es auto. La propiedad no se hereda; su valor calculado es la palabra clave especificada y su animación es discreta. Un valor en el elemento raíz (html) se aplica a la ventana gráfica; un valor en body no se propaga a ella.

Debido a las limitaciones de la plataforma o a las preferencias del usuario, thin puede tener el mismo aspecto que auto. No des por sentado un grosor concreto ni que la barra vaya a estar siempre visible. Usa barras más finas en espacios reducidos, no solo como adorno. Con none, ofrece una indicación visual de que se puede desplazar el contenido y controles alternativos para hacerlo, también para quienes usan un ratón sin rueda.

Un valor distinto de auto hace que se ignoren los mecanismos no estándar de estilo de las barras de desplazamiento, como la familia ::-webkit-scrollbar. El ejemplo usa overflow: auto para gestionar el contenido que desborda y scrollbar-width: thin únicamente para solicitar el grosor de las barras.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes