DEVELOPER REFERENCE · v4.0.0

ChoiceChips API

Props, callbacks and methods. Select an underlined type to explore its fields, allowed values and callback arguments.

ChoiceChips10 props1 callbacks0 methods

ChoiceChips props
Name	Type	Description
`value`Optional	`T \| readonly T[] \| undefined`Inspect type	Value to display or edit. The declared type identifies the supported representation; change callbacks describe how edited values are emitted.
`options`Required	`readonly ChoiceChipOption<T>[]`Inspect type	Available choices or control configuration, according to the declared type; expand it to inspect each field.
`ariaLabel`Required	`string`	Accessible name announced by assistive technology.
`appearance`Optional	`"soft" \| "outlined" \| undefined`	Selects a soft-filled or outlined chip presentation.
`scrollable`Optional	`boolean \| undefined`	Keep choices on one scrollable row, with hidden scrollbars and soft edge fades.
`size`Optional	`"small" \| "medium" \| undefined`	Visual size of this component; numeric icon/avatar sizes are in pixels, while controls use the declared named sizes.
`className`Optional	`string \| undefined`	Additional CSS classes applied to the component root.
`itemClassName`Optional	`string \| undefined`	Additional CSS classes for the item part of the component.
`disabled`Optional	`boolean \| undefined`	Disables user interaction with the control.
`testId`Optional	`string \| undefined`	Stable data attribute for locating the control in automated tests.

ChoiceChips events and callbacks
Name	Type	Description
`onChange`Required	`(value: T, option: ChoiceChipOption<T>) => void`Inspect type	Receives the new value when the user changes the control. Update the corresponding value prop for controlled use.

No component-specific imperative methods. Use props and callbacks to control this component.