Skip to content

Toggle Group

A toggle group is a segmented control for choosing exactly one value from a short list of mutually exclusive options.

Overview

Pass options (array of { value, label?, disabled? }) and bind modelValue as a single selected value.

catnip-toggle-group also provides:

  • Field label (prop or label slot), required / optional markers, info tooltip
  • supporting-text below the group (validation, hints)
  • variantdefault (white selected pill) or accent (brand selected pill)
  • sizem or l segment height (s / m field label → m segments; ll segments)
  • role="radiogroup" with aria-labelledby / aria-describedby wiring

Use catnip-radio-group when each option needs a full radio row with supporting text. Use catnip-tabs for navigation between views or panels.

Live example

Catnip Design System by Signicat