layout — wyrd.component.scroll-area

ScrollArea

Bounded workbench viewport with native scrolling and token-styled scrollbars.

Install @wyrd-company/react or the Flutter package and use it directly — your DESIGN.md does the styling.

01

Examples

Generated from the contract's examples block. Previews are the published @wyrd-company/react component, themed by the brand's role tokens — flip the site's light/dark toggle and they follow.

Code target Applies to every example on component pages.
vertical-pane state: default
design-systemcatalogstudiowebsitebrandproductreferencesworktreesdesign-systemcatalogstudiowebsitebrandproductreferencesworktrees
Usage
import { WyrdScrollArea } from "@wyrd-company/react";

<WyrdScrollArea label="Project files" orientation="vertical">
  design-system | catalog | studio | website | brand | product | references | worktrees
</WyrdScrollArea>
horizontal-timeline state: horizontal
DiscoverSpecifyBuildValidatePublishObserveRefineDiscoverSpecifyBuildValidatePublishObserveRefine
Usage
import { WyrdScrollArea } from "@wyrd-company/react";

<WyrdScrollArea label="Timeline" orientation="horizontal">
  Discover | Specify | Build | Validate | Publish | Observe | Refine
</WyrdScrollArea>
canvas state: both
TokensContractsRuntimeReactFlutterStudioDocumentationValidationTokensContractsRuntimeReactFlutterStudioDocumentationValidation
Usage
import { WyrdScrollArea } from "@wyrd-company/react";

<WyrdScrollArea label="Diagram canvas" orientation="both">
  Tokens | Contracts | Runtime | React | Flutter | Studio | Documentation | Validation
</WyrdScrollArea>
02

Properties

NameTypeDefaultSummary
label string undefined Meaningful accessible name for the scrollable region.
orientation vertical | horizontal | both vertical Axes on which native overflow scrolling is enabled.
03

Slots & events

SlotCardinalityAcceptsSummary
content one-or-many content, component Content contained by the bounded viewport.
04

Tokens

The contract's token bindings. Open the shared contextual sidebar from any example; primary swatches reflect the color you pick there. Error swatches show the active preset's values; editing any knob switches to custom and resets error to TWW · Ink.

BindingToken
scrollbar.thumb-color color.outline
scrollbar.track-color color.surface
scrollbar.thickness 8px
scrollbar.radius rounded.full
05

States

StateSourceSummary
default platform Vertically scrollable viewport.
horizontal property Horizontally scrollable viewport.
both property Viewport scrollable on both axes.
focus-visible platform Keyboard-visible focus on the scrollable region.
06

Accessibility

From the contract's accessibility obligations. Role region; Label property provides the required accessible name.

  • Tab reaches the scrollable region even when its content has no focusable descendants.
  • Platform scrolling keys scroll the focused region using native behavior.
  • Web projections set role=region, tabindex=0, and aria-label from the required label property.
  • Flutter exposes a labelled, focusable semantics container around the native scrollable.
  • The accessible name must be meaningful and unique within the page or view.
  • Verified under: rtl, density-compact, text-expansion.
07

SDUI

Status: blocked. Scroll Area is workbench chrome, not a Layout DSL node; native viewport behavior and host sizing remain implementation concerns.

SerializableMembers
Properties
Slots
Events
The Wyrding Way — a contract-first design system. © Wyrd Company