Skip to Content
Which part for what

Actions

Button and IconButton.

Button

SizeHeightUse
md28pxForms, panels, dialogs
sm24pxDense rows, list rows, table bars, toolbars
lg32pxEmpty states

Radius 6 at every size.

Variants
Open the example ↗
SizesSmall 24 for toolbars and table bars, default 28 for forms, large 32 for empty states.
Open the example ↗
  • primary is for the one action that completes a flow, such as the last button of a dialog or a form. The answer on a row and a sign-in are primary too.
  • accent starts AI work.
  • danger destroys.

Adding an item is a ghost plus IconButton among the header actions of the view. On a phone it is among the trailing actions of the navigation bar. It is never a primary or text button. The starting action of an empty state is a secondary Button.

Labels say what happens. Use one primary for each region.

A quiet plus to add; a filled button to finishNew issue is a ghost plus with its label as the tooltip, among the header's other actions. Create, in the dialog that follows, is the one primary.
Open the example ↗
A filled button with a plus to addThe loudest control on the screen starts something small, and says in words what its icon and tooltip already say.
Open the example ↗
A button may be coloured; it has no hue edgeDanger and accent buttons are fills. Hue fills belong to buttons and icon tiles only.
Open the example ↗
A hue outline around a hue fillThe snapshot's danger button: a red line around a red tint. The edge adds weight and says nothing new.
Open the example ↗
Shortcut, icons, link and loading
Open the example ↗
Button in the gallery ↗

IconButton

An IconButton is 28px with a 16px icon. size="sm" is 24px with a 13px icon.

label is required. It is the accessible name and the tooltip, so every icon-only control has words. Never use a bare <button> with an icon.

States
Open the example ↗
TooltipHover or focus a button. The tooltip inverts: a light chip on dark, with the shortcut beside the label.
Open the example ↗
IconButton in the gallery ↗

A DropdownMenu is a trigger and its Menu in a popover. Arrow Down opens it, and Escape closes it and returns focus. It flips when there is no room.

The Menu surface is shared by dropdowns, context menus and the command palette. Arrow Up and Down move with wrapping, and Home, End and typing a letter move too.

Rare actions go behind the overflow button.

Items, shortcuts, separator, danger
Open the example ↗
Rare actions behind the overflowExport, import and settings are used a few times a year: one icon button in the row that is already there.
Open the example ↗
A row of rare buttonsA toolbar for things done twice a year, every time the section is shown.
Open the example ↗
Menu in the gallery ↗
Edit on GitHub

Last updated on

On this page