Skip to main content

Button

MD3 common button: five variants, five sizes, round/square shapes with the Expressive press morph.

Variants​

<Button variant="filled">Filled</Button>

Sizes​

Shapes​

Press a square button and hold — the corner radius morphs per the Expressive spec.

Disabled​

Props​

PropTypeDefaultDescription
defaultSelectedbooleanfalseUncontrolled initial selected state (toggle mode).
endIconReactNode—Trailing icon (decorative).
onChange((event: MouseEvent<HTMLButtonElement, MouseEvent>, selected: boolean) => void)—Fires with the triggering event and the next selected state when toggled.
selectedboolean—Controlled selected state (toggle mode).
shapeenumroundResting shape; both shapes morph to a tighter corner while pressed.
sizeenumsmContainer size on the Expressive scale.
startIconReactNode—Leading icon (decorative).
togglebooleanfalseEnable toggle (selectable) behavior with `aria-pressed` (Expressive). Inside a `ButtonGroup` with `selectionMode`, give the button a `value` instead — the group then owns its selection.
variantenumfilledVisual emphasis.