Ballmac UI home

Scroll Area

A focusable, named scroll region with theme-aware custom thumb and native scrolling behavior for long lists and documents.

Recent activity

Everything happening in your workspace

  • New files uploaded

    Design assets · 2 minutes ago

  • Comment added

    Q3 product brief · 18 minutes ago

  • Review completed

    Release checklist · 1 hour ago

  • Preview updated

    Launch page · 3 hours ago

  • Feedback received

    Brand guide · Yesterday

Installation

The default, and what a Radix-style project installs.

$ pnpm dlx shadcn@latest add @ballmac/scroll-area

Usage

import { ScrollArea, ScrollBar } from "@/components/ballmac/scroll-area"

The full example is in the Code tab above.

Examples

Horizontal gallery

Project stages

01

Planning

02

Design

03

Build

04

Review

05

Launch

API reference

PropTypeDefault
label*

Accessible name of the focusable reading region.

string—

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
TabFocuses the named scroll region
Arrow keys / Page Up / Page DownScrolls the focused region

Quality scorecard

7/7

Every applicable check passes

Measured in Chromium 153.0.8010.12 on October 19, 2026, on version 1.0.0, across 2 examples.

How we measure
  • Passed: Accessibility scan

    No serious or critical issues in light and dark, on a phone and a desktop (axe-core 4.13.0, WCAG 2.1 AA and best-practice rules).

  • Passed: Small screens

    No sideways scrolling at 360, 390 or 1280 px wide.

  • Passed: Reduced motion

    No endless animation to begin with.

  • Passed: Right to left

    Mirrors correctly in Arabic, Hebrew, Persian and Urdu layouts (0% of elements off the mirror, limit 15%).

  • Passed: Clean console

    No console errors or React hydration errors while loading.

  • Passed: Keyboard

    2 tab stops, each showing a visible change when it takes focus. 2 documented keys.

  • Not applicable: Loading, empty and error

    Does not show data or take submissions.

  • Passed: Automated tests

    Covered by scroll-area.test.tsx.

  • For information: Footprint

    0.7 KB of source (gzip) in 1 file. Installs radix-ui.

Automated checks find a subset of problems and do not replace testing with a screen reader and a keyboard in your own app. What they miss.

Use with AI

Constrains long content in an accessible keyboard-scrollable region without changing native scroll behavior. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Scroll Area (@ballmac/scroll-area) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Activity feeds and long lists
  • Constrained side panels

Not for

  • Short content that can fit naturally
  • The main page scroll

Registry JSON: https://ui.ballmac.com/r/scroll-area.json

Credits

Free to use in personal and commercial projects.

Registry
shadcn/utils

Ballmac UI Pro

Need the whole screen, not one piece?

311 premium blocks (dashboards, settings, calendars, mail, shops, onboarding), a private shadcn registry and Figma tokens. Blocks that show data come with loading, empty and error states built in.

Not ready? Try three Pro blocks free

Leave your email and the blocks appear right here, ready to copy. Yours to use in any project.