Área de desplazamiento

import * as React from "react"

import { ScrollArea } from "@/components/ui/scroll-area"

El área de desplazamiento sustituye las barras de scroll predeterminadas del navegador por otras que tú estilizas: el desplazamiento nativo sigue debajo, así que la rueda, el gesto táctil y la inercia quedan intactos. Está construida sobre el componente Base UI Scroll Area y sigue la receta neobrutalista: un tirador sólido y grueso en el color del borde y un anillo de foco marcado sobre el viewport.

Recurre a este componente cuando:

• Paneles de chat y de logs — fija la altura y deja que los mensajes se desplacen dentro del panel, no en la página.
• Barras laterales y árboles de archivos — listas de navegación largas que se desplazan con independencia del contenido principal.
• Franjas horizontales — filas de etiquetas, galerías de tarjetas y tablas anchas con orientation="horizontal".

Instalación#

pnpmnpmyarnbun
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/scroll-area.json
npx shadcn@latest add https://neobrutalism.com/r/base/scroll-area.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/scroll-area.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/scroll-area.json
Copiar

pnpmnpmyarnbun
pnpm add @base-ui/react
npm install @base-ui/react
yarn add @base-ui/react
bun add @base-ui/react
Copiar

"use client"

import * as React from "react"
import { ScrollArea as ScrollAreaPrimitive } from "radix-ui"

import { cn } from "@/lib/utils"

function ScrollArea({
  className,
  children,
  ...props
}: React.ComponentProps<typeof ScrollAreaPrimitive.Root>) {
  return (
    <ScrollAreaPrimitive.Root
      data-slot="scroll-area"
      className={cn("relative", className)}
      {...props}
    >
      <ScrollAreaPrimitive.Viewport
        data-slot="scroll-area-viewport"
        className="size-full rounded-[inherit] transition-[color,box-shadow] outline-none focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary"
      >
        {children}
      </ScrollAreaPrimitive.Viewport>
      <ScrollBar />
      <ScrollAreaPrimitive.Corner />
    </ScrollAreaPrimitive.Root>
  )
}

function ScrollBar({
  className,
  orientation = "vertical",
  ...props
}: React.ComponentProps<typeof ScrollAreaPrimitive.ScrollAreaScrollbar>) {
  return (
    <ScrollAreaPrimitive.ScrollAreaScrollbar
      data-slot="scroll-area-scrollbar"
      data-orientation={orientation}
      orientation={orientation}
      className={cn(
        "flex touch-none p-px transition-colors select-none data-horizontal:h-2.5 data-horizontal:flex-col data-horizontal:border-t data-horizontal:border-t-transparent data-vertical:h-full data-vertical:w-2.5 data-vertical:border-l data-vertical:border-l-transparent",
        className
      )}
      {...props}
    >
      <ScrollAreaPrimitive.ScrollAreaThumb
        data-slot="scroll-area-thumb"
        className="relative flex-1 rounded bg-border"
      />
    </ScrollAreaPrimitive.ScrollAreaScrollbar>
  )
}

export { ScrollArea, ScrollBar }

Uso#

Copiarimport { ScrollArea, ScrollBar } from "@/components/ui/scroll-area"

Copiar<ScrollArea className="h-[200px] w-[350px] rounded-md border p-4">
  Your scrollable content here.
</ScrollArea>

Composición#

Usa la siguiente composición para construir un ScrollArea:

CopiarScrollArea
└── ScrollBar

Ejemplos#

Horizontal#

Usa ScrollBar con orientation="horizontal" para un desplazamiento horizontal.

import * as React from "react"
import Image from "next/image"

RTL#

Para activar el soporte RTL en Neobrutalism, consulta la guía de configuración de RTL.

"use client"

import * as React from "react"

Accesibilidad#

No existe un patrón WAI-ARIA para las áreas de desplazamiento, y tampoco hace falta: el componente de Base UI conserva debajo un contenedor de scroll nativo real, de modo que el desplazamiento con rueda, táctil y por teclado se comporta exactamente igual que el del navegador. No todos los navegadores hacen enfocable por sí solos un contenedor de scroll: si el contenido no incluye elementos enfocables, añade tabIndex={0} y un aria-label al viewport para que quienes usan teclado puedan alcanzarlo y desplazarlo; los estilos ya incluyen un anillo de foco visible para ese caso. La barra de desplazamiento y el tirador personalizados son recursos solo de puntero; nunca deben ser la única forma de desplazarse.

Referencia de API#

Consulta la documentación Base UI Scroll Area.