Skip to main content
Mat Expressive

MatExpButtonGroup

mat-exp-button-group
Component

Component that groups buttons and provides single/multi-select behavior compatible with Angular reactive and template-driven forms.

Models

NameTypeDefaultDescription
disabledModelSignal<boolean | undefined> —

Inputs

NameTypeDefaultDescription
sizeMatExpButtonSize | undefined 's'
shapeMatExpButtonShape | undefined 'round'
selectionMatExpButtonGroupSelection | undefined 'single-select'
variantMatExpButtonGroupVariant | undefined 'standard'
appearanceMatExpButtonGroupAppearance | undefined —
disableBounceboolean | undefined false

Disables the M3 Expressive press-bounce animation (see button-group.animation.ts). Only has an effect on the standard variant, which is the only variant the bounce ever runs on.

valueunknown —

The currently selected value. For single-select this is a single value; for multi-select this is an array of values.

Outputs

NameEvent typeDescription
selectionChangeMatExpSelectableButtonChange

Emits when the selected value changes, either via user interaction or programmatic update.