Examples
Default
Secondary Variant
Disabled
Media Controls
Editing Tools
Props
ButtonIconGroup
A pre-composed cluster ofIconButtons for toolbars and action rows (media controls, editing tools, content action bars). Items are spaced with a fixed 4px gap and stay individually rounded — this is a spaced group, not a segmented/joined control.
Exposes role="group" by default; pass an aria-label or aria-labelledby to describe the cluster for assistive technology.
This is a presentational layout primitive: it does not implement roving-tabindex / arrow-key focus management. role is overridable, but if you set an interactive-widget role such as role="toolbar" you own the keyboard behaviour that role implies. For orientation-aware roles the aria-orientation is synced to orientation automatically.
ReactNode
required
The icon buttons to cluster together. Compose
IconButton elements here; the group only handles layout and spacing."horizontal" | "vertical"
default:"horizontal"
Direction the icon buttons flow in. Use
vertical for side rails and stacked media controls.Exported types
Also exported from@fanvue/ui: ButtonIconGroupOrientation, ButtonIconGroupProps.
Setup: Installation · Theming