Pular para o conteúdo
1.6k

Área de rolagem

Um contêiner com rolagem e barras de rolagem personalizadas, compatíveis com todos os navegadores, para painéis de bate-papo, barras laterais e árvores de arquivos — com um botão de rolagem robusto no estilo neobrutalista.

import * as React from "react"

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

A scroll area substitui as barras de rolagem padrão do navegador por barras que você estiliza — a rolagem nativa continua por baixo, então o comportamento de roda, toque e inércia permanece intacto. Construída sobre o componente Base UI Scroll Area e estilizada com a receita neobrutalista: um thumb sólido e encorpado na cor da borda e um anel de foco duro no viewport.

Quando usar:

  • Painéis de chat e de logs — fixe a altura e deixe as mensagens rolarem dentro do painel, não na página.
  • Sidebars e árvores de arquivos — listas de navegação longas que rolam independentemente do conteúdo principal.
  • Faixas horizontais — fileiras de tags, galerias de cards e tabelas largas via orientation="horizontal".

Instalação

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

Instale as seguintes dependências:

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

Copie e cole o código a seguir no seu projeto.

components/ui/scroll-area.tsx
"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 }

Atualize os caminhos de importação conforme a configuração do seu projeto.

Uso

import { ScrollArea, ScrollBar } from "@/components/ui/scroll-area"
<ScrollArea className="h-[200px] w-[350px] rounded-md border p-4">
  Your scrollable content here.
</ScrollArea>

Composição

Use a seguinte composição para construir um ScrollArea:

ScrollArea
└── ScrollBar

Exemplos

Horizontal

Use ScrollBar com orientation="horizontal" para rolamento horizontal.

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

RTL

Para ativar o suporte a RTL no Neobrutalism, consulte o guia de configuração de RTL.

"use client"

import * as React from "react"

Acessibilidade

Não existe um padrão WAI-ARIA para áreas de rolagem — e nenhum é necessário, porque o componente do Base UI mantém um contêiner de rolagem nativo de verdade por baixo, então rolar com a roda, o toque ou o teclado funciona exatamente como no próprio navegador. Nem todo navegador torna um contêiner de rolagem focável por teclado por conta própria: se o conteúdo não tiver elementos focáveis, adicione tabIndex={0} e um aria-label ao viewport para que usuários de teclado consigam alcançá-lo e rolá-lo — os estilos já incluem um anel de foco visível para esse caso. A barra de rolagem e o thumb personalizados são recursos exclusivos de ponteiro; eles nunca devem ser a única forma de rolar.

Referência da API

Consulte a documentação Base UI Scroll Area.