Light themes
Dark themes

Make your own

Button

A button starts an action; the yellow one is the single most important action in view.

Sizes: 64, 56, 48 and 40px

With an icon, icon only, with a value, disabled, busy

Playground

One button: its look, its size, an icon and its state. The markup under it is what you copy.

HTML

Variants

ClassUse
tray-btnPrimary: accent fill, on-accent text. One per view.
tray-btn tray-btn--darkSolid ink. The main action on a yellow surface, or a second strong action.
tray-btn tray-btn--quietSecondary: grey on white, white on a tray. The default for everything that is not the main action.
tray-btn tray-btn--ghostNo fill until hover. Toolbars, dialogs, "Cancel".
tray-btn tray-btn--dangerDeletes or cancels something for good. Never the only way to back out.
tray-btn tray-btn--linkAn action that reads as a link inside text.

Sizes

tray-btn is 64px (size-lg, type action). Add tray-btn--md (56px, sits in a row with inputs), tray-btn--sm (48px, headers and toolbars) or tray-btn--xs (40px, tables and dense rows). tray-btn--icon makes it square; tray-btn--block full width; tray-btn--split pushes a value to the far end ("Order a jar … $59").

You provide

  • The label: a verb first, sentence case, no full stop ("Order a jar", "Save changes").
  • For an icon-only button, an aria-label.
  • Use <a class="tray-btn"> when it goes somewhere, <button type="button"> when it does something.

States

Hover darkens the fill slightly, press scales to 0.97, keyboard focus draws a 3px ink ring 3px out. A disabled button keeps its fill at opacity-disabled. While work is running set aria-busy="true" and put a tray-spinner before the label; keep the label.

Accessibility

It is the browser's own <button> or <a>: Tab reaches it, Enter presses either, and Space presses a <button>. Its text is its name, and every icon inside is aria-hidden. The focus ring takes the ink of the surface it sits on, so it shows on the yellow and the ink card too. disabled takes a button out of the tab order; to keep it reachable, use aria-disabled="true", which looks the same, and ignore its presses yourself. The spinner of a busy button is aria-hidden, so the label carries the state, and under prefers-reduced-motion: reduce the spinner turns slowly instead of stopping.

Do and don't

  • Do keep one primary button per view (the One Yellow Rule).
  • Don't put two yellow buttons side by side; make the second one quiet.
  • Don't use the danger button for a routine "Remove filter".
↑↓ to moveEnter to openEsc to close