Skip to main content
ComponentsNavigation

Component · Navigation

Segmented Control

View mode List/Grid/Table exclusive segments.

Kind
widget
Input
interactive
Canvas
120×40

Live preview

Loading terminal preview.

Static terminal poster. Choose Run live to start the Rust demo.

Ghosttysegmented-control/basic
Loading terminal poster…
○ loading posterNo input — rendered state only
Segmented Control · exact mounted Rust story

01 · Purpose

What it is for

View mode List/Grid/Table exclusive segments.

Best fit: Navigation · navigation · widget

02 · Behavior

What the mounted story proves

  1. 01

    SegmentedControl

    Representative 120×40 terminal state.

  2. 02

    Passive paint

    No keyboard or pointer action is claimed by this representative story.

  3. 03

    Evidence stays explicit

    3 covered · 8 partial · 5 missing axes.

03 · Implement

Install, then start from exact code

Install

cargo add termrock --git https://github.com/tailrocks/termrock.git --rev 5283c2acf9154d0cfcd37b1ffe821c00faf90ea2

Add TermRock once. Keep domain effects in the host application.

Minimal implementation

Exact Rust setup used by segmented-control/basic.

Open to load code.

04 · Adapt

Variants and composition

Variants

Use the preview Variant menu when alternate registered stories exist. Each selection mounts a fresh configuration.

Composition

Navigation · navigation · widget

05 · Reference

API, tokens, accessibility

API

SegmentedControlOpen source ↗

Tokens

DesignSystemInspect exact story code for roles and capability projection.

Accessibility

Input contract mountedNo input claim in the representative story.

Contract

Evidence in progress3/23 axes covered

06 · Go deeper

Advanced guidance

Authored implementation guidance

Selection

SegmentedControlState::selected() is the read path. Hosts update selection through set_selected, which keeps the active cursor synchronized, including when clearing the selection with None. Keyboard and menu commits use the same setter.

Ownership boundary

TermRock owns reusable terminal rendering and interaction state. The host owns domain data, policy, persistence, authorization, and side effects.

Evidence status

3 covered, 8 partial, and 5 missing contract axes. Missing evidence is not a behavior claim.