Saltar al contenido

ScrollArea

Contenedor de scroll acotado con scrollbar propio: más fino que el de la página y hover-reveal (el thumb aparece al pasar el mouse o al enfocar adentro). Se acota con un alto o un ancho máximos (data-ts-max-height, data-ts-max-width). Es el que usan por dentro los paneles largos.

Estructura · TaishoDS Core, en HTML plano.

Ejemplos

Un ejemplo por caso, funcionando. Cada ejemplo es el HTML de su vista previa: se copia tal cual y, con el CSS y el JS del Core cargados, se ve y funciona igual.

Registro de actividad con scroll

Ana Torres desplegó «Panel de control» en Producción.

Bruno Díaz canceló un despliegue de «Sitio marketing».

Carla Ruiz aprobó los cambios de «API de pagos».

Diego Sosa movió «App móvil» a Staging.

Elena Vega invitó a un nuevo miembro como Lector.

El despliegue de «Data pipeline» quedó en cola.

html

Cuándo usarlo

  • Una zona tiene que scrollear por su cuenta sin arrastrar la página: una lista, un panel.
  • El contenido supera el alto disponible y se busca acotarlo, no truncarlo.
  • Se busca el mismo scrollbar fino de los paneles del sistema.

Cuándo no

  • Es el scroll de la página entera: se deja al navegador.
  • El contenido entra: un scroll que nunca aparece sólo estorba.

Cómo usarlo

  • Se acota con una altura máxima (data-ts-max-height) en vez de una altura fija: se adapta mejor.
  • Debe quedar visible que hay más abajo — un corte limpio parece final de contenido.

Cómo no usarlo

  • No se anidan áreas de scroll: el usuario nunca sabe cuál está moviendo.
  • No se esconden ahí acciones importantes que quedan fuera de la vista.

TaishoDS Core

Necesita el JS del Core: lo engancha por atributos data-ts-*.

El tope de alto o ancho es un valor continuo: lo leen --ts-scroll-area-max-h y --ts-scroll-area-max-w, y esas variables las escribe el Core. Hasta que el Core corre, sólo tienen tope los valores de la escala (ts max-h-160) y 100%, que llevan su clase; cualquier otro valor queda sin tope.

El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.

  • data-ts-max-height

Qué hace: La medida CSS (180px, 30rem) se pasa en data-ts-max-height o data-ts-max-width. El Core la lleva a la variable al iniciar y cuando el atributo cambia. El scroll es el nativo del navegador.

Sin build, desde el CDN: taisho.scroll-area.css, además de taisho.base.css. Con ese archivo alcanza.

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

  • El contenedor scrollable recibe tabindex="0" para ser alcanzable por teclado (regla axe scrollable-region-focusable).

Verificación

Qué se probó de verdad. Lo que no se probó lo dice: preferimos un «sin verificar» a una afirmación de más.

  • axe WCAG 2.2 A + AA en navegador real, en tema claro y oscuro, antes de cada versión.
  • teclado No agrega teclas propias: usa el comportamiento nativo del navegador.
  • lector de pantalla Sin verificar con lector de pantalla. Conviene probarlo en la combinación de componentes propia, no sólo aquí, donde cada uno aparece solo y en su estado feliz.