id: scroll_area
label: Scroll Area
family: family-f-data
category: Layout
intent: Scrollable container with custom scrollbar
description: Scrollable area container
composable: false
capabilities: Overflow
required_parts: []
optional_parts: []
tags: ["scroll-area", "scroll", "overflow", "container", "long-list"]
keywords:
pain: Custom scroll containers break keyboard navigation and accessibility
promise: Scroll behavior and accessibility enforced via structured container
why: |
ScrollAreaPrimitive defines viewport, scrollbars and orientation explicitly. ARIA roles and keyboard access are enforced. This guarantees accessible scrolling behavior.
rules: ["CR-001", "CR-004"]
use_cases: ["long lists", "logs"]
related: ["card", "resizable", "aspect_ratio", "page_header", "toolbar", "separator"]
file: scroll_area_ui.css
tokens: scroll-area-*, scrollbar-*, scroll-*, size-*, radius-*, motion-*
foundation: size, radius, motion
states: ["active"]
island: scroll_area_boundary.rs
pillar: layout
badges: ["SSR Safe", "Hydration Safe", "Token Driven", "Deterministic API", "Zero Drift", "Island Architecture"]
before: |
// ❌ Typical
view! {
<div style="overflow:auto;height:200px"></div>
}
after: |
// ✅ CanonRS
view! {
<ScrollArea>
<div>"Content"</div>
</ScrollArea>
}
boundary_type: interaction
ix_group: ix_gesture
block: []
blocks_primitives: [container, stack]