Instalación
npx logic2b@next add scroll-areaUso
import { ScrollArea } from "@/components/ui/scroll-area"
<ScrollArea className="h-72 w-48 rounded-md border">
El bufón comenzó a colarse en el castillo en mitad de la noche...
</ScrollArea>
Define el tamaño del viewport con className —alto y ancho— y el contenido se
desplazará en su interior. Para desplazamiento horizontal, genera un ScrollBar
con orientation="horizontal" dentro de ScrollArea.
Accesibilidad
El viewport admite foco mediante teclado por defecto, así que las flechas, Re Pág, Av Pág, Inicio y Fin siguen disponibles aunque el contenido no tenga descendientes interactivos. El anillo de foco visible identifica qué región controla esas teclas.
Ejemplos
Horizontal
Texto largo
Playground interactivo
Edita las propiedades del componente y revisa el JSX exacto antes de copiarlo. La vista previa se carga solo cuando esta sección entra en pantalla.
<ScrollArea
className="h-48 w-full max-w-md rounded-lg border"
aria-label="Release notes"
>
<div
className="space-y-4 p-4"
>
<p
className="font-medium"
>Release 1.2</p>
<p
className="text-sm text-muted-foreground"
>Versioned registry manifests and integrity checks.</p>
<p
className="font-medium"
>Release 1.1</p>
<p
className="text-sm text-muted-foreground"
>Portable design tokens for web, iOS and Android.</p>
<p
className="font-medium"
>Release 1.0</p>
<p
className="text-sm text-muted-foreground"
>The first stable component registry.</p>
</div>
</ScrollArea>Referencia de API
Generada a partir de las exportaciones públicas de TypeScript en src/ui/scroll-area.tsx. Las descripciones técnicas conservan el texto canónico del código fuente.
ScrollArea
ComponenteProps: React.ComponentProps<typeof ScrollAreaPrimitive.Root>ScrollBar
ComponenteProps: React.ComponentProps<typeof ScrollAreaPrimitive.ScrollAreaScrollbar>| Propiedad | Tipo | Obligatoria | Valor predeterminado | Descripción |
|---|---|---|---|---|
orientation | "horizontal" | "vertical" | No | "vertical" | — |
Contrato de accesibilidad
Comportamiento legible por máquinas y responsabilidades de quien integra scroll-area. Los detalles normativos conservan el texto canónico del registro.
- Soporte
- Gestionado por la primitiva
- Patrón
- scrollable region
- Radix Scroll Area
| Teclas | Comportamiento |
|---|---|
| ArrowUp ArrowDown ArrowLeft ArrowRight PageUp PageDown | Scroll a focused scroll container with the keyboard. |
Semántica incorporada
- Preserves the semantics of its children while providing custom visual scrollbars.
Responsabilidades de integración
- Make the viewport focusable and label it only when the region itself needs keyboard scrolling or landmark semantics.