# RatingGroup

Keyboard-operable whole or half-step rating control.

Use RatingGroup to collect or display a rating on a short ordered scale. Its flat gold fill shows the current value without decorative depth.

## API

The package declarations define these public members.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `allowHalf` | `boolean` | prop | No | `false` | Half-star precision. |
| `disabled` | `boolean` | prop | No | `false` | No additional description. |
| `icon` | `IconGlyph` | prop | No | `StarIcon` | Glyph. Defaults to a star. |
| `label` | `string` | prop | No | `undefined` | No additional description. |
| `max` | `number` | prop | No | `5` | No additional description. |
| `onValueChange` | `(value: number) => void` | callback | No | `undefined` | No additional description. |
| `readonly` | `boolean` | prop | No | `false` | No additional description. |
| `size` | `ControlSize` | prop | No | `'md'` | No additional description. |
| `value` | `number` | binding | No | `0` | Current rating. Two-way bindable. |

## Related

- [Label](/docs/components/label): Visible form label with required-state treatment.
- [Input](/docs/components/input): Single-line field with internal or external labeling, hint, error, icons, and password reveal.
- [Switch](/docs/components/switch): Bindable binary switch with visible or aria-only labeling.