IconButton
Square Button variant where the only child is an icon. Carbon-spec: same kind matrix as Button, square sizes, requires `aria-label` for accessibility.
primitives-iconbutton--defaultOpen all variants →
When to use
- Toolbar / table-row triggers where space is tight and the icon's meaning is unambiguous (close, edit, delete, more-actions).
- Wrap with `Tooltip` so the
aria-labeltext also surfaces visually on hover.
When not to use
- Any trigger where text would fit → use `Button`. Icon-only loses meaning for users who don't recognise the glyph.
- Action menus with multiple options → use `DropdownMenu` anchored to an IconButton (typical pattern).