پرش به محتوا

ناحیه پیمایش

یک کانتینر قابل پیمایش با نوارهای پیمایش سفارشی و سازگار با همه مرورگرها برای پنجره‌های چت، نوارهای کناری و درخت‌های فایل — با یک انگشت شست حجیم نئوبروتالیست.

import * as React from "react"

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

ناحیهٔ اسکرول نوارهای اسکرول پیش‌فرض مرورگر را با نوارهایی که شما استایل می‌دهید جایگزین می‌کند — اسکرول بومی زیرین می‌ماند، پس رفتار چرخ، لمس و momentum دست‌نخورده است. بر پایهٔ Base UI Scroll Area ساخته شده و با دستور پخت نئوبروتالیستی استایل شده: thumb حجیم و solid به رنگ حاشیه و حلقهٔ فوکوس سخت روی viewport.

برای این موارد از آن استفاده کنید:

  • پنل چت و log — ارتفاع را ثابت کنید و بگذارید پیام‌ها داخل پنل اسکرول شوند نه صفحه.
  • Sidebar و درخت فایل — فهرست‌های ناوبری بلند که مستقل از محتوای اصلی اسکرول می‌شوند.
  • نوار افقی — ردیف تگ، گالری کارت و جدول عریض از طریق orientation="horizontal".

نصب

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

وابستگی‌های زیر را نصب کنید:

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

کد زیر را کپی کرده و در پروژهٔ خود جای‌گذاری کنید.

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 }

مسیرهای import را مطابق با پیکربندی پروژهٔ خود به‌روزرسانی کنید.

استفاده

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

ترکیب

برای ساخت یک ScrollArea، از ترکیب زیر استفاده کنید:

ScrollArea
└── ScrollBar

نمونه‌ها

افقی

برای اسکرول افقی، از ScrollBar با orientation="horizontal" استفاده کنید.

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

RTL

برای فعال‌سازی پشتیبانی RTL در Neobrutalism، راهنمای پیکربندی RTL را ببینید.

"use client"

import * as React from "react"

دسترسی‌پذیری

الگوی WAI-ARIA برای ناحیهٔ اسکرول وجود ندارد — لازم هم نیست، چون کامپوننت Base UI یک کانتینر اسکرول بومی واقعی زیرین نگه می‌دارد تا چرخ، لمس و اسکرول صفحه‌کلید دقیقاً مثل خود مرورگر رفتار کنند. هر مرورگری کانتینر اسکرول را به‌تنهایی keyboard-focusable نمی‌کند: اگر محتوا عنصر focusable ندارد، tabIndex={0} و aria-label به viewport اضافه کنید تا کاربران صفحه‌کلید برسند و اسکرول کنند — استایل‌ها از قبل حلقهٔ فوکوس نمایان برای آن حالت دارند. نوار اسکرول و thumb سفارشی فقط affordance اشاره‌گرند؛ هرگز نباید تنها راه اسکرول باشند.

مرجع API

مستندات Base UI Scroll Area را ببینید.