コンテンツへスキップ
1.6k

スクロール領域

チャットペイン、サイドバー、ファイルツリー用に、カスタムでクロスブラウザ対応のスクロールバーを備えたスクロール可能なコンテナです。太めのネオブルータリズム調のスクロールバーが特徴です。

import * as React from "react"

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

Scroll Area は、ブラウザ既定のスクロールバーをスタイル可能なものに差し替えます。ネイティブのスクロールは下層に残るため、ホイール、タッチ、慣性の挙動はそのままです。Base UI Scroll Area コンポーネント上に構築し、ネオブルータリストのレシピに沿ってスタイルしています。枠線色のしっかりした太いサムと、ビューポート上の硬いフォーカスリングです。

次のような場面で使います：

  • チャットとログペイン — 高さを固定し、メッセージはパネル内でスクロール（ページ全体ではない）。
  • サイドバーとファイルツリー — メインコンテンツと独立してスクロールする長いナビ一覧。
  • 横スクロールの帯 — 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 { 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

Neobrutalism で RTL を有効にする方法は、RTL 設定ガイドをご覧ください。

"use client"

import * as React from "react"

アクセシビリティ

Scroll Area に WAI-ARIA パターンはなく、必要もありません。Base UI コンポーネントは下層に本物のネイティブスクロールコンテナを保つため、ホイール、タッチ、キーボードのスクロールはブラウザ本体と同じです。すべてのブラウザがスクロールコンテナをキーボードフォーカス可能にするわけではないため、中身にフォーカス可能な要素がない場合はビューポートに tabIndex={0} と aria-label を付け、キーボードユーザーが到達してスクロールできるようにしてください。スタイルにはその場合用の見えるフォーカスリングが既に含まれます。カスタムのスクロールバーとサムはポインター専用の手がかりであり、スクロールの唯一の手段にしてはいけません。

APIリファレンス

詳しくは Base UI のドキュメントをご覧ください。