Vai al contenuto
1.6k

Area di scorrimento

Un contenitore scorrevole con barre di scorrimento personalizzate e compatibili con tutti i browser per finestre di chat, barre laterali e alberi di file — con un cursore massiccio in stile neobrutalista.

import * as React from "react"

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

La scroll area sostituisce le barre di scorrimento predefinite del browser con barre che puoi stilizzare — lo scorrimento nativo resta sotto, quindi rotellina, tocco e inerzia rimangono intatti. Costruita sul componente Base UI Scroll Area e rifinita secondo la ricetta neobrutalista: un thumb pieno e massiccio nel colore del bordo e un anello di focus netto sul viewport.

Quando usarlo:

  • Pannelli di chat e log — fissa l’altezza e lascia che i messaggi scorrano dentro il pannello, non nella pagina.
  • Sidebar e alberi dei file — lunghi elenchi di navigazione che scorrono indipendentemente dal contenuto principale.
  • Strisce orizzontali — file di tag, gallerie di card e tabelle larghe tramite orientation="horizontal".

Installazione

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

Installa le seguenti dipendenze:

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

Copia e incolla il seguente codice nel tuo progetto.

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 }

Aggiorna i percorsi di importazione in base alla configurazione del tuo progetto.

Utilizzo

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

Composizione

Usa la seguente composizione per costruire una ScrollArea:

ScrollArea
└── ScrollBar

Esempi

Orizzontale

Usa ScrollBar con orientation="horizontal" per lo scorrimento orizzontale.

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

RTL

Per abilitare il supporto RTL in Neobrutalism, consulta la guida alla configurazione RTL.

"use client"

import * as React from "react"

Accessibilità

Non esiste un pattern WAI-ARIA per le scroll area — e non serve, perché il componente Base UI mantiene sotto un vero contenitore di scorrimento nativo, quindi rotellina, tocco e scorrimento da tastiera si comportano esattamente come quelli del browser. Non tutti i browser rendono un contenitore di scorrimento focalizzabile da tastiera di per sé: se il contenuto non contiene elementi focalizzabili, aggiungi tabIndex={0} e un aria-label al viewport, così chi usa la tastiera può raggiungerlo e farlo scorrere — gli stili includono già un anello di focus visibile per questo caso. La barra di scorrimento personalizzata e il thumb sono affordance riservate al puntatore; non devono mai essere l’unico modo di scorrere.

Riferimento API

Consulta la documentazione Base UI Scroll Area.