# ScrollArea

> A scroll container with themed scrollbars, ready for panels and lists.

- Category: [Window & layout](https://tarve.dev/docs.md#layout)
- Import: `import { ScrollArea } from "@tarve/core";`
- Source: [packages/core/src/components/scroll.ts:29](https://github.com/omarcosr/tarve/blob/main/packages/core/src/components/scroll.ts#L29)

## Usage

```tsx title="ScrollArea.tsx"
import { Column, ScrollArea, Text } from "@tarve/core";

<ScrollArea orientation="both" style={{ width: 360, height: 220 }}>
  <Column gap={8} style={{ width: 720, padding: 12 }}>
    {Array.from({ length: 16 }, (_, index) => (
      <Text key={index}>Line {index + 1}: content wider than the area scrolls on both axes inside a themed scroll area.</Text>
    ))}
  </Column>
</ScrollArea>
```

## Props

ScrollArea has no props of its own beyond the inherited and common props below.

### Inherited from `ViewProps`

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `align` | `Style["align"]` | — |  |
| `autoFocus` | `boolean` | — | Focus this control when it first appears (HTML `autofocus`); interactive views only (Pressable). |
| `children` | `BindableChild` | — |  |
| `dismissOnOutside` | `boolean` | — | A press outside the box fires `onOutsideClick` instead of reaching what is under it (light dismiss). Works on portals and in-flow boxes; an open portal wins. |
| `dragRegion` | `boolean` | — |  |
| `flex` | `number \| string` | — | CSS `flex`: `1` is `1 1 0`; strings take any CSS value, e.g. `"1 1 176px"`. |
| `focusable` | `boolean` | — |  |
| `gap` | `number` | — |  |
| `justify` | `Style["justify"]` | — |  |
| `onOutsideClick` | `() => void` | — | With `dismissOnOutside`: a press (or right click) outside the box. |
| `padding` | `Style["padding"]` | — |  |
| `portal` | `boolean` | — |  |
| `style` | `Reactive<Style>` | — | Values may be signals: setting one restyles this box without a render. |
| `windowAction` | `"minimize" \| "toggleMaximize" \| "toggleFullscreen" \| "close"` | — |  |

### Inherited from `ScrollProps`

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `followTail` | `boolean` | — | Stick to the end: while the area is at its end (or new), growing content keeps it there (a chat, a log). Scrolling away stops it; scrolling back to the end resumes it. |
| `onScroll` | `(offset: number, max: number, info: ScrollInfo) => void` | — |  |
| `onScrollPosition` | `(position: ScrollPosition) => void` | — |  |
| `orientation` | `ScrollOrientation` | — |  |
| `speed` | `number` | — |  |

## Common props

Shared by every component (descriptions: https://tarve.dev/docs.md#common-props): `class`, `className`, `dropTarget`, `fileDropTarget`, `highlight`, `id`, `key`, `motionFrom`, `onDragEnter`, `onDragLeave`, `onDrop`, `onFileDragEnter`, `onFileDragLeave`, `onFileDrop`, `onHighlight`, `onPaste`, `onPointerLeave`, `onPointerMove`, `onSize`, `onTransitionEnd`, `rovingGroup`.

## Types

```ts title="BindableChild"
type BindableChild = Child | Signal<unknown> | BindableChild[];
```

```ts title="Reactive"
type Reactive<S> = { [K in keyof S]: S[K] | Signal<Exclude<S[K], undefined>> };
```

```ts title="ScrollInfo"
interface ScrollInfo { source: ScrollSource }
```

```ts title="ScrollOrientation"
type ScrollOrientation = "vertical" | "horizontal" | "both";
```

```ts title="ScrollPosition"
interface ScrollPosition { x: number; y: number; maxX: number; maxY: number; source: ScrollSource }
```

Previous: [Scroll](https://tarve.dev/docs/components/Scroll.md) · Next: [Overflow](https://tarve.dev/docs/components/Overflow.md)

---

Tarve v0.13.8 · HTML version: https://tarve.dev/docs/components/ScrollArea · Index for agents: https://tarve.dev/llms.txt
