Button

Triggers an action or event. Six variants, four sizes. Uses <button> or <a>. Zero JavaScript required.

Component Skill — components/button/component-skill.md

Native basis

<button> element. Also works on <a> for link-style buttons.

Web Platform APIs

<button> :focus-visible commandfor / command prefers-reduced-motion prefers-contrast forced-colors

Classes

.btn

Variants (data-variant)

defaultPrimary fill, white text secondaryMuted fill, dark text outlineBorder + shadow, transparent fill ghostTransparent, accent on hover destructiveRed fill for danger actions linkInline text link, underline on hover

Sizes (data-size)

xsHeight: 1.75rem smHeight: 2rem lgHeight: 2.75rem iconHeight: 2.25rem icon-xsHeight: 1.75rem icon-smHeight: 2rem icon-lgHeight: 2.75rem

Notes

• The link variant resets height and padding — it flows inline.

• SVGs inside buttons auto-size to 1rem unless they have a size-* class.

• The button works on <a> tags for styled navigation links.

Variants

Six styles via data-variant. Default has a solid primary fill.

<button class="btn" data-variant="default">Default</button>
<button class="btn" data-variant="secondary">Secondary</button>
<button class="btn" data-variant="outline">Outline</button>
<button class="btn" data-variant="ghost">Ghost</button>
<button class="btn" data-variant="destructive">Destructive</button>
<button class="btn" data-variant="link">Link</button>

Sizes

Four sizes via data-size, plus icon-only variants.

<button class="btn" data-variant="outline" data-size="xs">Extra Small</button>
<button class="btn" data-variant="outline" data-size="sm">Small</button>
<button class="btn" data-variant="outline">Default</button>
<button class="btn" data-variant="outline" data-size="lg">Large</button>

Icon

Square button for icon-only actions. Requires aria-label.

<button class="btn" data-variant="outline" data-size="icon-xs"
        aria-label="Settings">
  <svg aria-hidden="true" width="12" height="12" ...>...</svg>
</button>

<button class="btn" data-variant="outline" data-size="icon-sm"
        aria-label="Settings">
  <svg aria-hidden="true" width="14" height="14" ...>...</svg>
</button>

<button class="btn" data-variant="outline" data-size="icon"
        aria-label="Settings">
  <svg aria-hidden="true" width="15" height="15" ...>...</svg>
</button>

<button class="btn" data-variant="outline" data-size="icon-lg"
        aria-label="Settings">
  <svg aria-hidden="true" width="18" height="18" ...>...</svg>
</button>

With Icon

Icons auto-size to 1rem. Place before or after the label.

<button class="btn" data-variant="default">
  <svg aria-hidden="true" width="15" height="15" ...>...</svg>
  GitHub
</button>

<button class="btn" data-variant="outline">
  <svg aria-hidden="true" width="15" height="15" ...>...</svg>
  Download
</button>

Disabled button with a spinning icon to indicate pending action.

<button class="btn" data-variant="default" disabled>
  <svg aria-hidden="true" width="15" height="15"
       style="animation: spin 1s linear infinite;"
       viewBox="0 0 24 24" fill="none" stroke="currentColor"
       stroke-width="2">
    <path d="M21 12a9 9 0 1 1-6.219-8.56"/>
  </svg>
  Loading...
</button>

Disabled

50% opacity, no pointer events.

<button class="btn" data-variant="default" disabled>Default</button>
<button class="btn" data-variant="outline" disabled>Outline</button>
<button class="btn" data-variant="secondary" disabled>Secondary</button>

As Link

Use <a> instead of <button> for navigation.

Navigate Learn more

<a href="/page" class="btn" data-variant="default">Navigate</a>
<a href="/docs" class="btn" data-variant="outline">Learn more</a>

Rounded

Add style="border-radius:9999px" or a Tailwind rounded-full class for pill-shaped buttons.

<button class="btn" data-variant="default" style="border-radius:9999px;">Rounded</button>
<button class="btn" data-variant="outline" data-size="icon"
        aria-label="Arrow up" style="border-radius:9999px;">
  <svg ...>...</svg>
</button>

CSS view file

/* -- Button component ------------------------------------------ */

@layer components {
  .btn {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    gap: 0.5rem;
    white-space: nowrap;
    font-size: 0.875rem;
    font-weight: 500;
    font-family: var(--font-sans);
    line-height: 1;
    border-radius: var(--radius-md);
    border: 1px solid transparent;
    cursor: pointer;
    text-decoration: none;
    transition: all 150ms ease;
    outline: none;
    flex-shrink: 0;
    height: 2.25rem;
    padding: 0 1rem;
    background-color: var(--primary);
    color: var(--primary-foreground);

    & svg {
      pointer-events: none;
      flex-shrink: 0;

      &:not([class*="size-"]) { width: 1rem; height: 1rem; }
    }

    &:focus-visible {
      outline: 2px solid var(--ring);
      outline-offset: 2px;
    }

    &:disabled, &[aria-disabled="true"] {
      pointer-events: none;
      opacity: 0.5;
    }

    /* -- Variants -------------------------------------------- */
    &[data-variant="default"] {
      background-color: var(--primary);
      color: var(--primary-foreground);

      &:hover { opacity: 0.9; }
    }

    &[data-variant="secondary"] {
      background-color: var(--secondary);
      color: var(--secondary-foreground);

      &:hover { opacity: 0.8; }
    }

    &[data-variant="outline"] {
      background-color: var(--background);
      color: var(--foreground);
      border: 1px solid var(--border);
      box-shadow: var(--shadow-xs);

      &:hover {
        background-color: var(--accent);
        color: var(--accent-foreground);
      }
    }

    &[data-variant="ghost"] {
      background-color: transparent;
      color: var(--foreground);
      border-color: transparent;

      &:hover {
        background-color: var(--accent);
        color: var(--accent-foreground);
      }
    }

    &[data-variant="destructive"] {
      background-color: var(--destructive);
      color: var(--destructive-foreground);

      &:hover { opacity: 0.9; }
    }

    &[data-variant="link"] {
      background-color: transparent;
      color: var(--primary);
      height: auto;
      padding: 0;
      text-underline-offset: 4px;

      &:hover { text-decoration: underline; }
    }

    /* -- Sizes ----------------------------------------------- */
    &[data-size="xs"]      { height: 1.75rem; padding: 0 0.5rem;  font-size: 0.75rem; border-radius: var(--radius-sm); }
    &[data-size="sm"]      { height: 2rem;    padding: 0 0.75rem; font-size: 0.8125rem; }
    &[data-size="lg"]      { height: 2.75rem; padding: 0 2rem;    font-size: 1rem; }
    &[data-size="icon"]    { height: 2.25rem; width: 2.25rem;  padding: 0; }
    &[data-size="icon-xs"] { height: 1.75rem; width: 1.75rem;  padding: 0; border-radius: var(--radius-sm); }
    &[data-size="icon-sm"] { height: 2rem;    width: 2rem;     padding: 0; }
    &[data-size="icon-lg"] { height: 2.75rem; width: 2.75rem;  padding: 0; }
  }

  /* -- Accessibility ------------------------------------------ */

  @media (prefers-reduced-motion: reduce) {
    .btn { transition: none; }
  }

  @media (prefers-contrast: more) {
    .btn {
      border: 2px solid transparent;

      &[data-variant="default"],
      &[data-variant="secondary"],
      &[data-variant="destructive"] {
        border-color: currentColor;
      }

      &[data-variant="outline"],
      &[data-variant="ghost"] {
        border-color: var(--foreground);
      }
    }
  }

  @media (forced-colors: active) {
    .btn {
      border: 1px solid ButtonText;

      &:disabled, &[aria-disabled="true"] {
        border-color: GrayText;
        color: GrayText;
      }
    }
  }
}