Navigation

SegmentedControl

An iOS-style segmented picker that lets people flip between a small set of equally-weighted options, like Day, Week, and Month. The selected segment lifts onto its own elevated pill inside the shared track.

Overview

An iOS-style segmented picker that lets people flip between a small set of equally-weighted options, like Day, Week, and Month. The selected segment lifts onto its own elevated pill inside the shared track.

Day
Week
Month

Variants and states

default
default
Day
Week
Month

Anatomy

SegmentedControl
Day
Week
Month
  1. 1Container  required
  2. 2Segment  required
  3. 3Label  required
  4. 4Root  slot

Measurements

Day
Week
Month
Height, padding, gaps, and radius, measured live from the rendered component

Specs

Values resolved live from the token spine. Token names follow the active platform; each links to its page.

Container
Track corner radius
radiusSm
8pt
Track padding (all sides)
spacingPaddingXs
2pt
#0000000A · 4%
Segment
Segment corner radius
radiusXs
6pt
Segment horizontal padding
spacingPaddingLg
12pt
Segment vertical padding
spacingPaddingSm
4pt
Gap between segments
spacingGapPositiveXs
4pt
Selected segment fill
colorBackgroundElevatedPrimary
#FFFFFF
#FFFFFF00 · 0%
Label
Selected segment label
colorContentPrimary
#0C1828
Unselected segment label
colorContentSecondary
#6D747E
Segment label typography
body.md.medium
Size 17px · typographyFontSizeBodyMdLine height 22px · typographyLineHeightBodyMdWeight 500 · typographyFontWeightMediumTracking -0.41px · typographyTrackingBodyMdParagraph spacing 0px · typographyParagraphSpacingBodyMdFamily SF Pro Text · typographyFontFamilyText

Properties

The component’s Figma API, the properties you set on an instance. Useful to designers in Figma and to engineers mapping it to code props.

PropertyTypeValues
Rootinstance

Accessibility

Ensure a minimum 44 by 44pt tap target for any interactive instance, adding surrounding padding when the component itself is shorter. Keep text concise, and never rely on color alone to convey meaning; pair it with a label or an icon so the message survives for color-blind and low-vision users.

Reference: Apple Human Interface Guidelines and WCAG 2.5.5 Target Size.