Skip to content

Segmented control

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

View as Markdown

Preview

Post status

<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>

API

React props (NxKit)

React (NxKit) props
PropTypeDefaultRequiredDescription
labelstringRequiredGroup name (aria-label).
options{ value; label; count? }[]Required2-5 options.
valueTRequiredSelected value.
onChange(value: T) => voidRequiredAlso fires on arrow keys.

Classes

Framework-agnostic classes
ClassDescription
.nx-segGroup
.nx-seg__item--onSelected: 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.

View in spec