macOS Interface More detail B · Official guidance Platform: macOS

macOS Segmented Control

A macOS Segmented Control is a short row of joined choices. It switches a view, filter, or closely linked mode.

See how it works
You might call it segmented controlNSSegmentedControlsegmented picker

See how it works

Original worked examplemacOS Segmented Control

Another example

A Finder-style browser uses toolbar segments for icon, list, column, and gallery views.

Main parts

  1. 01Visible label
  2. 02Interaction target
  3. 03Current state
  4. 04Keyboard behavior

Use it when

Use it for a few equal modes or filters with short labels. Each choice should quickly change the same nearby content.

Do not use it when

Avoid long or wrapped labels, too many choices, and unrelated destinations. Do not hide an effect until after a separate confirmation.

Name used in code

NSSegmentedControl / SwiftUI Picker with segmented style

Before you ship

Check the supported macOS versions and AppKit or SwiftUI integration. Check standard focus and keyboard behavior. Also check VoiceOver, Full Keyboard Access, window resizing, and multi-window state. When needed, check restore, localization, and reduced motion.

Request you can copy

Outcome: Apply or review macOS Segmented Control in a native macOS app without breaking platform rules. User context: A Finder-style browser uses toolbar segments for icon, list, column, and gallery views. macOS concept or control: macOS Segmented Control. Why it fits: Use it for a few equal modes or filters with short labels. Each choice should quickly change the same nearby content. Do not use it when: Avoid long or wrapped labels, too many choices, and unrelated destinations. Do not hide an effect until after a separate confirmation. Platform requirements: List the supported macOS versions. Say whether AppKit or SwiftUI owns each part and how they connect. Define window, menu, focus, keyboard, saved state, restore, and multi-window behavior. Platform accessibility and resilience: Use the right accessibility APIs. Check VoiceOver and Full Keyboard Access. Support localization, contrast, and reduced motion when needed. Keep user state after a relaunch. Acceptance criteria: Check the behavior on supported macOS versions with a keyboard and VoiceOver. Window resizing, focus, state restore, and AppKit or SwiftUI integration work in the normal macOS way. Evidence and limits (evidence boundary): It is official for that source. Other platforms or teams may use the term in another way. Unknowns to confirm: Supported macOS versions, AppKit or SwiftUI structure, and window model. Also confirm sandbox and entitlement limits, save rules, and the accessibility goal.

Check this request

Review the current use of macOS Segmented Control. Definition: A macOS Segmented Control is a short row of joined choices. It switches a view, filter, or closely linked mode. Release checks: Check the supported macOS versions and AppKit or SwiftUI integration. Check standard focus and keyboard behavior. Also check VoiceOver, Full Keyboard Access, window resizing, and multi-window state. When needed, check restore, localization, and reduced motion. Before changing code, report the evidence you found, gaps, severity, and the smallest safe fix.

B
How official is this term?

Official guidance

The named platform, framework, project, or expert group has an official guide for this term.

It is official for that source. Other platforms or teams may use the term in another way.

Scope
macOS
Document status
stable
Checked on
2026-07-30

Evidence sources & scope

Authority source · Apple · stable Segmented controls Scope: Apple segmented controls Role here: Authority within stated scope Source covers: canonical name, definition, platform API, implementation, usage guidance Background source Apple Human Interface Guidelines — Designing for macOS Role here: Helpful background, not a definition

Copy it yourself

The browser could not copy this. Select the request below and copy it yourself.