Segmented Control

Segmented control with a raised thumb that springs between options, arrow, Home and End key support, icons, badges, three sizes and reduced motion support.

src/registry/ui/segmented-control.tsx/r/segmented-control.json

Click or use arrow keys

Installation#

bash

npx shadcn@latest add @minidev/segmented-control

MiniDev UI is in the shadcn registry directory, so the short form works with no setup. Older CLI versions can use the full URL: npx shadcn@latest add https://ui.minidev.pro/r/segmented-control.json

Usage#

tsx

import { SegmentedControl } from "@/components/ui/segmented-control"

export function Example() {
  return (
    <SegmentedControl disabled items={["Day", "Week", "Month"]} aria-label="Disabled range" />
  )
}

API reference#

SegmentedControl props
Prop	Type	Default
`options`	`Option[]`	`-`
`items`	`string[]`	`-`
`value`	`string`	`-`
`defaultValue`	`string`	`-`
`onChange`	`(value: string) => void`	`-`
`size`	`Size`	`"default"`
`fullWidth`	`boolean`	`-`
`disabled`	`boolean`	`-`
`className`	`string`	`-`
`aria-label`	`string`	`-`

Dependencies#

npm

motion

Built from

No other MiniDev files

Examples#

Segmented controlGliding thumb, keyboard, badges

AutocompleteText input that filters string options as you type, using ARIA combobox and listbox roles. Works controlled or uncontrolled and lists up to eight matches.Calendar MonthMonth calendar grid with weekday headers and clickable day cells that highlight the selected date. A simple Tailwind base for date views and schedulers.Character CountLive React character counter that shows the current count against a limit and turns red when it goes over. Announces changes politely to screen readers.Checkbox GroupVertical wrapper that groups related checkboxes under role group with even spacing. Use it with Checkbox and labels for multi select settings.CheckboxShadcn style checkbox on Base UI with an animated check, indeterminate state, invalid and disabled styles, and an enlarged hit area for touch.Chip FilterSingle select filter chips in React that behave as a radio group, with an accent ring on the active chip. Good for quick filters above lists and tables.

All form components

Learn more

Build a SaaS pricing page in React and TailwindGuide How to install components from a custom shadcn registryGuide Dark mode in Next.js without the flashGuide What is Controlled component?Glossary What is Dark mode?Glossary What is Neumorphism?Glossary