The Button Toggle component lets users choose one or more states from a short set of related options. Use it as a compact selection control for modes, formatting, filters, density, alignment, or other preferences where the selected state should stay visible.
Use it for:
- Mode switching: Select one view, format, sorting mode, period, or layout density.
- Multiple compact choices: Let users select several short options in the same group.
- Persistent state: Show the current value directly on the control.
- Form values: Bind selected values through Angular forms.
Do not use Button Toggle to run actions, navigate between pages, handle long option lists, or replace radio, checkbox, select, slide toggle, or tabs when those controls better match the task.