Przejdź do treści
1.6k

Obszar przewijania

Przewijalny kontener z niestandardowymi, działającymi we wszystkich przeglądarkach paskami przewijania do okien czatu, pasków bocznych i drzew plików — z masywnym suwakiem w stylu neobrutalistycznym.

import * as React from "react"

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

Obszar przewijania zastępuje domyślne paski przewijania przeglądarki takimi, które stylujesz samodzielnie — natywne przewijanie działa pod spodem, więc zachowanie kółka myszy, dotyku i przewijania z rozpędem pozostaje nietknięte. Zbudowany na komponencie Base UI Scroll Area i ostylowany zgodnie z neobrutalistyczną recepturą: masywny, jednolity suwak w kolorze ramki i twardy pierścień fokusa na viewporcie.

Sięgnij po to rozwiązanie, gdy:

  • Panele czatu i logów — ustal wysokość i pozwól wiadomościom przewijać się wewnątrz panelu, a nie na stronie.
  • Paski boczne i drzewa plików — długie listy nawigacyjne przewijane niezależnie od głównej treści.
  • Poziome pasy — rzędy tagów, galerie kart i szerokie tabele dzięki orientation="horizontal".

Instalacja

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

Zainstaluj następujące zależności:

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

Skopiuj i wklej poniższy kod do swojego projektu.

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 }

Zaktualizuj ścieżki importu, aby pasowały do konfiguracji twojego projektu.

Użycie

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

Kompozycja

Użyj poniższej kompozycji, aby zbudować ScrollArea:

ScrollArea
└── ScrollBar

Przykłady

Poziomy

Użyj ScrollBar z orientation="horizontal" do przewijania w poziomie.

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

RTL

Aby włączyć obsługę RTL w Neobrutalism, zobacz przewodnik konfiguracji RTL.

"use client"

import * as React from "react"

Dostępność

Dla obszarów przewijania nie istnieje wzorzec WAI-ARIA — i żaden nie jest potrzebny, bo komponent Base UI zachowuje pod spodem prawdziwy natywny kontener przewijania, więc przewijanie kółkiem myszy, dotykiem i klawiaturą działa dokładnie tak jak w samej przeglądarce. Nie każda przeglądarka sama z siebie czyni kontener przewijania fokusowalnym z klawiatury: jeśli treść nie zawiera elementów fokusowalnych, dodaj do viewportu tabIndex={0} i aria-label, aby użytkownicy klawiatury mogli do niego dotrzeć i go przewijać — style zawierają już widoczny pierścień fokusa na taką sytuację. Niestandardowy pasek przewijania i suwak to udogodnienia wyłącznie dla wskaźnika; nigdy nie mogą być jedynym sposobem przewijania.

Referencja API

Zobacz dokumentację Base UI Scroll Area.