# Scroll Area

A scrollable region with custom scrollbars.

## Installation

```bash
npx shadcn@latest add https://landorui.landorestate.com/r/scroll-area.json
```

[Registry JSON](https://landorui.landorestate.com/r/scroll-area.json)

## Preview

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

const tags = Array.from({ length: 20 }, (_, i) => `Item ${i + 1}`);

export function Preview() {
  return (
    <ScrollArea className="h-40 w-full max-w-sm rounded-md border p-4">
      <div className="space-y-2 text-sm">
        {tags.map((tag) => (
          <p key={tag}>{tag}</p>
        ))}
      </div>
    </ScrollArea>
  );
}
```


## Source

### ui/scroll-area.tsx

```tsx
"use client";

import { ScrollArea as ScrollAreaPrimitive } from "@base-ui/react/scroll-area";

import { cn } from "@/lib/utils";

function ScrollArea({ className, children, ...props }: ScrollAreaPrimitive.Root.Props) {
  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:ring-[3px] focus-visible:ring-ring/50 focus-visible:outline-1"
      >
        {children}
      </ScrollAreaPrimitive.Viewport>
      <ScrollBar />
      <ScrollAreaPrimitive.Corner />
    </ScrollAreaPrimitive.Root>
  );
}

function ScrollBar({
  className,
  orientation = "vertical",
  ...props
}: ScrollAreaPrimitive.Scrollbar.Props) {
  return (
    <ScrollAreaPrimitive.Scrollbar
      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.Thumb
        data-slot="scroll-area-thumb"
        className="relative flex-1 rounded-full bg-border"
      />
    </ScrollAreaPrimitive.Scrollbar>
  );
}

export { ScrollArea, ScrollBar };
```



## Usage

A scrollable region with custom scrollbars.

```tsx
import { ScrollArea, ScrollBar } from "@/components/ui/scroll-area";
```