# Segmented control

> 2-5 mutually exclusive views or filters with radio semantics and optional counts.

- Group: Navigation
- Status: stable
- Aliases: seg, toggle-group
- HTML page: https://design.ipmnx.com/components/segmented/
- Spec: https://design.ipmnx.com/design/#nx-segmented

## Preview

**Post status**

```html
<div class="nx-seg" role="radiogroup" aria-label="Status">
  <button type="button" role="radio" aria-checked="true"
      tabindex="0" class="nx-seg__item nx-seg__item--on">
    All
    <span class="nx-seg__count">12</span>
  </button>
  <button type="button" role="radio" aria-checked="false"
      tabindex="-1" class="nx-seg__item">
    Draft
    <span class="nx-seg__count">4</span>
  </button>
  <button type="button" role="radio" aria-checked="false"
      tabindex="-1" class="nx-seg__item">
    Published
    <span class="nx-seg__count">8</span>
  </button>
</div>
```

```tsx
<NxSegmented
  label="Status"
  value={status}
  onChange={setStatus}
  options={[
    { value: "all", label: "All", count: 12 },
    { value: "draft", label: "Draft", count: 4 },
    { value: "published", label: "Published", count: 8 },
  ]}
/>
```

## API

### React props (NxKit)

| Prop | Type | Default | Required | Description |
| --- | --- | --- | --- | --- |
| `label` | `string` |   | yes | Group name (aria-label). |
| `options` | `{ value; label; count? }[]` |   | yes | 2-5 options. |
| `value` | `T` |   | yes | Selected value. |
| `onChange` | `(value: T) => void` |   | yes | Also fires on arrow keys. |

### Classes

| Class | Description |
| --- | --- |
| `.nx-seg` | Group |
| `.nx-seg__item--on` | Selected: accent fill |

## Accessibility

- role=radiogroup / radio, aria-checked, roving tabindex; arrow keys move and select.

## Do / Don't

- Do: Use for 2-5 views of the same list.
- Don't use for actions. Those are buttons.

## Related

- [Tabs](https://design.ipmnx.com/components/tabs.md)
- [Select](https://design.ipmnx.com/components/select.md)

---

Source: registry.js (NX Design System)
