Navigation

Scrollbars

Bind a viewport offset to arrow, track, wheel, and thumb input.

The site build compiles the dedicated Ada component example, constructs Scrollbars through its public API, and exports that exact styled surface. Read the capture source.

When to use it

Use a scrollbar beside a real scrollable region. The application owns the two-way synchronization with content offsets.

State and ownership

The Flyology_TUI.Components.Scrollbars package defines this component.

The model retains orientation, range, page size, first item, focus, and capture. It does not own the scrolled content.

The application model owner applies updates during serial event dispatch.
Appearance and skin values are borrowed only while the component renders.

Input and updates

Arrows move one unit, track clicks move one page, wheel moves by signed magnitude, and thumb drag uses captured motion.

Integration sequence

Create the bounded model and populate it with caller-owned data.
Route the current keyboard or local mouse event through the component handler.
Apply the typed result, then render from the updated model with the current appearance.

See the linked package reference for its exact declarations and contracts.

Responsive and accessible behavior

Use dimensions and regions from the current layout or presentation value.
When a component owns mouse capture, route its matching release even when the pointer leaves the original bounds.
Retain a glyph, label, border, or text-attribute cue when the terminal reduces color.