recursica-skill-segmented-control

Guides correct usage of the Recursica segmented control for horizontal single-select interfaces.

1|Updated May 29, 2026
One-click install
npx skills add https://github.com/borderux/recursica-knowledge --skill recursica-skill-segmented-control-borderux
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: recursica-skill-segmented-control
Source: https://github.com/borderux/recursica-knowledge/tree/main/skills/components/recursica-skill-segmented-control
Command: npx skills add https://github.com/borderux/recursica-knowledge --skill recursica-skill-segmented-control-borderux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Choosing and implementing the wrong single-select control leads to inconsistent UI, broken accessibility, and misuse of tabs or radio buttons. This Skill defines exactly when a segmented control is the right choice in the Recursica design system and how to implement it correctly. ## Core Features & Use Cases - Control Selection Rules: Distinguishes segmented controls from radio groups, dropdowns, tabs, chips, and switches, with a strict 2–5 option ceiling that overrides the general 7 ± 2 rule. - Variant & Token Guidance: Documents the orientation and fill-width axes from the Recursica UI kit, clarifying that horizontal is the house pattern and no size or style axis exists. - Accessibility Requirements: Specifies radio-group semantics, single tab stop, arrow-key selection, accessible naming for icon-only segments, and distinguishable focus versus selection states. - Use Case: When building a list/grid view switcher in a toolbar, apply this Skill to confirm a segmented control is correct, keep labels to one or two words, and wire it as a proper radio group for screen readers. ## Quick Start Ask the AI to review or implement a horizontal single-select view switcher using the Recursica segmented control guidelines.

Frequently Asked Questions about recursica-skill-segmented-control

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
When should I use a segmented control instead of radio buttons?▼

Use a segmented control when the layout calls for a horizontal single-select with 2 to 5 short-labeled options, such as a view switcher or inline filter. Radio buttons remain the house pattern for vertical single-selects and are never rotated into a row.

What is the difference between a segmented control and tabs?▼

A segmented control holds the values of a single-select field, while tabs hold parts of one whole with their own content and routes. They are not interchangeable, and tabs must never be the fallback when a segmented control's option set grows beyond five.

How many options can a segmented control have?▼

A segmented control supports 2 to 5 options, and this ceiling overrides the general 7 ± 2 house rule because the control is horizontal and compact. Larger sets should use a vertical radio group or a dropdown instead.

How do I make a segmented control accessible for screen readers?▼

Build it as a radio group with an accessible group name, programmatic selected state, and explicit names for icon-only segments. The group must be a single tab stop with arrow keys moving selection, and focus must land on the selected segment.

Can a segmented control be used for multi-select?▼

No, a segmented control is strictly single-select with exactly one option always selected. For multi-select, use selectable chips horizontally or a checkbox group vertically instead.

When should I not use a segmented control?▼

Avoid it when there are more than five options, labels are long, switching triggers heavy reloads or destructive actions, or the choice is a simple on/off state. Those cases call for a dropdown, radio group, explicit submission control, or switch.