# ButtonGroup

These contracts describe the evolving 0.2.0 Alpha edition.
Read [Installation](/docs/installation/) to select the matching alpha package or the stable documentation.

## Component contract

| Required props | Options and defaults |
| --- | --- |
| options, value, onChange | variant="chip", size="md", deselectable=false, block=false, aria-label |

Shared application peers: `react >=19.0.0`, `react-dom >=19.0.0`.
Your application supplies React 19 and React DOM 19.


Read the [full component reference](https://github.com/hannasage/projection-ui/blob/d03bbaeb0321b95106207959e19c35e004438ff1/docs/components.md) for supported values and interaction behavior.

## Examples

[ButtonGroup: Metric selection (md)](/examples/?path=/story/components-buttongroup--metric-selection)

[ButtonGroup: Year clip chips (sm, deselectable)](/examples/?path=/story/components-buttongroup--year-clip-chips)

[ButtonGroup: Return mode selector](/examples/?path=/story/components-buttongroup--return-mode)

[ButtonGroup: Block (full width)](/examples/?path=/story/components-buttongroup--block-layout)

[ButtonGroup: Large size](/examples/?path=/story/components-buttongroup--large-size)

[ButtonGroup: Disabled option](/examples/?path=/story/components-buttongroup--with-disabled-option)

[ButtonGroup: Radius — Sharp](/examples/?path=/story/components-buttongroup--radius-sharp)

[ButtonGroup: Radius — Rounded](/examples/?path=/story/components-buttongroup--radius-rounded)