Zum Inhalt springen
1.6k

Scrollbereich

Ein scrollbarer Container mit benutzerdefinierten, browserübergreifenden Bildlaufleisten für Chat-Fenster, Seitenleisten und Dateibäume – mit einem klobigen, neobrutalistischen Schieberegler.

import * as React from "react"

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

Die Scroll Area ersetzt die Standard-Scrollbalken des Browsers durch eigene, frei gestaltbare – das native Scrollen bleibt darunter erhalten, Mausrad-, Touch- und Trägheitsverhalten bleiben also unangetastet. Sie basiert auf der Base UI Scroll Area-Komponente und folgt dem neobrutalistischen Rezept: ein solider, klobiger Thumb in der Rahmenfarbe und ein harter Fokusring auf dem Viewport.

Typische Anwendungsfälle:

  • Chat- und Log-Bereiche – die Höhe fixieren und Nachrichten im Panel scrollen lassen statt auf der Seite.
  • Sidebars und Dateibäume – lange Navigationslisten, die unabhängig vom Hauptinhalt scrollen.
  • Horizontale Leisten – Tag-Zeilen, Kartengalerien und breite Tabellen per orientation="horizontal".

Installation

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

Installiere die folgenden Abhängigkeiten:

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

Kopiere den folgenden Code und füge ihn in dein Projekt ein.

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 }

Passe die Importpfade an dein Projekt-Setup an.

Verwendung

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

Komposition

Verwende die folgende Komposition, um eine ScrollArea aufzubauen:

ScrollArea
└── ScrollBar

Beispiele

Horizontal

Verwende ScrollBar mit orientation="horizontal" für horizontales Scrollen.

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

RTL

Um RTL-Unterstützung in Neobrutalism zu aktivieren, sieh dir die RTL-Konfigurationsanleitung an.

"use client"

import * as React from "react"

Barrierefreiheit

Für Scroll Areas gibt es kein WAI-ARIA-Pattern – und es braucht auch keins, denn die Base-UI-Komponente behält darunter einen echten nativen Scroll-Container, sodass sich Mausrad-, Touch- und Tastatur-Scrollen exakt wie im Browser selbst verhalten. Nicht jeder Browser macht einen Scroll-Container von sich aus per Tastatur fokussierbar: Enthält der Inhalt keine fokussierbaren Elemente, gib dem Viewport tabIndex={0} und ein aria-label, damit Tastaturnutzer ihn erreichen und scrollen können – die Styles bringen für diesen Fall bereits einen sichtbaren Fokusring mit. Der eigene Scrollbalken samt Thumb ist eine reine Zeiger-Affordanz und darf nie der einzige Weg zum Scrollen sein.

API-Referenz

Sieh dir die Dokumentation von Base UI Scroll Area an.