Button

Uso

import { Button } from '@/components/atoms/Button';

<Button variant="primary" size="m" animated>
  Save
</Button>

Props

Gotchas

• react

  Text-swap animation needs the real label as children string/node; do not replace children with a custom spinner while loading — use the loading prop.

• a11y

  Keep a clear accessible name; icon-only usage belongs on icon-button, not button with empty children.

• css-modules

  Button CSS is global BEM (.btn*). Import the published stylesheet globally; CSS Modules will scope classes and break styles.

Anatomía CSS

<div class="button">
  <span class="button__icon"></span>
  <span class="button__label"></span>
  <span class="button__spinner"></span>
  <span class="button__spinner-icon"></span>
</div>

Tokens resueltos

Valores finales tras seguir la cadena de tokens. Derivados del source: si un token cambia, esta tabla cambia sola.

Animaciones

CSS mínimo funcional

Autocontenido: sin imports ni tokens. Para previews y prototipos — en producción se consume el CSS del DS (@atom-uikit/css/components.css</code>, <code>@atom-uikit/tokens/tokens.css).

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

   Sizing: explicit height + padding per size (shadcn/Radix convention).
   Gap, radius, icon-size remain em-relative for proportional scaling.

   Variants: primary, secondary, tertiary,
             destructive, destructive-secondary, destructive-tertiary
   Sizes:    xs, s, m (default), l, xl
   States:   enabled, hover, focus, active, disabled, loading
   ------------------------------------------------------------------------- */

.button {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  gap: 0.5em;
  border-radius: 0.625em;
  border: 1px solid transparent;
  font-family: 'inter tight', -apple-system, blinkmacsystemfont, 'segoe ui', roboto, helvetica, arial, sans-serif, ui-sans-serif, system-ui, sans-serif;
  font-weight: 500;
  line-height: 1;
  width: auto;
  max-width: 100%;
  cursor: pointer;
  user-select: none;
  -webkit-tap-highlight-color: transparent;
  text-decoration: none;
  box-shadow: 0 0 #0000;
  transition:
    background-color 300ms cubic-bezier(0.22, 1, 0.36, 1),
    color 300ms cubic-bezier(0.22, 1, 0.36, 1),
    border-color 300ms cubic-bezier(0.22, 1, 0.36, 1),
    scale 500ms cubic-bezier(0.32, 0.72, 0, 1);
  position: relative;
}

.button:active:not(.button--disabled):not(.button--loading) {
  scale: 0.955 0.925;
}

.button:focus-visible {
  outline: 2px solid #0a0a0a;
  outline-offset: 1.5px;
}

@media (hover: hover) and (pointer: fine) and (prefers-reduced-motion: no-preference) {
  .button[data-button-animate]:hover:not(.button--disabled):not(.button--loading) {
    scale: 1.06 1.095;
  }
}

@media (prefers-reduced-motion: reduce) {
  .button {
    transition-duration: 0ms;
  }
  .button:active:not(.button--disabled) {
    scale: 1;
  }
}

/* ---- Sizes (same font-size, different height + padding) ---- */

.button--xs {
  height: 28px;
  padding: 0 8px;
  font-size: 12.8px;
}

.button--s {
  height: 32px;
  padding: 0 12px;
  font-size: 12.8px;
}

.button--m {
  height: 40px;
  padding: 0 16px;
  font-size: 12.8px;
}

.button--l {
  height: 48px;
  padding: 0 24px;
  font-size: 12.8px;
}

.button--xl {
  height: 52px;
  padding: 0 32px;
  font-size: 12.8px;
}

/* ---- Variants ---- */

.button--primary {
  background-color: #0a0a0a;
  color: #fafafa;
}
.button--primary:hover:not(.button--disabled) {
  background-color: #262626;
}
.button--primary:active:not(.button--disabled) {
  background-color: #f5f5f5;
}

.button--secondary {
  background-color: #fafafa;
  color: #0a0a0a;
  border-color: #e5e5e5;
}
.button--secondary:hover:not(.button--disabled) {
  background-color: #f5f5f5;
}
.button--secondary:active:not(.button--disabled) {
  background-color: #f5f5f5;
}

.button--tertiary {
  background-color: #00000000;
  color: #0a0a0a;
}
.button--tertiary:hover:not(.button--disabled) {
  background-color: #f5f5f5;
}
.button--tertiary:active:not(.button--disabled) {
  background-color: #f5f5f5;
}

.button--destructive-primary {
  background-color: #f84131;
  color: #0a0a0a;
}
.button--destructive-primary:hover:not(.button--disabled) {
  background-color: #c21e12;
}
.button--destructive-primary:active:not(.button--disabled) {
  background-color: #c21e12;
}

.button--destructive-secondary {
  background-color: #fafafa;
  color: #f84131;
  border-color: #f84131;
}
.button--destructive-secondary:hover:not(.button--disabled) {
  background-color: #f5f5f5;
}
.button--destructive-secondary:active:not(.button--disabled) {
  background-color: #f5f5f5;
}

.button--destructive-tertiary {
  background-color: #00000000;
  color: #f84131;
}
.button--destructive-tertiary:hover:not(.button--disabled) {
  background-color: #f5f5f5;
}
.button--destructive-tertiary:active:not(.button--disabled) {
  background-color: #f5f5f5;
}

/* ---- States ---- */

.button--disabled {
  color: #525252;
  cursor: not-allowed;
  pointer-events: none;
}

.button--disabled.button--primary,
.button--disabled.button--secondary,
.button--disabled.button--destructive-primary,
.button--disabled.button--destructive-secondary {
  background-color: #f5f5f5;
  border-color: transparent;
}

.button--disabled.button--tertiary,
.button--disabled.button--destructive-tertiary {
  background-color: transparent;
  border-color: transparent;
}

.button--loading {
  cursor: wait;
  pointer-events: none;
}

.button--loading .button__label {
  opacity: 0;
}

.button--loading .button__spinner {
  position: absolute;
  inset: 0;
  display: flex;
  align-items: center;
  justify-content: center;
}

/* ---- Parts ---- */

.button__icon {
  display: flex;
  align-items: center;
  justify-content: center;
  flex-shrink: 0;
  width: 1em;
  height: 1em;
}

.button__icon svg {
  width: 100%;
  height: 100%;
}

.button__label {
  display: inline-flex;
  align-items: center;
}


.button__spinner {
  display: none;
}

.button--loading .button__spinner {
  display: flex;
}

.button__spinner-icon {
  animation: button-spin 700ms linear infinite;
}

@keyframes button-spin {
  to { transform: rotate(360deg); }
}

@media (prefers-reduced-motion: reduce) {
  .button__spinner-icon {
    animation: none;
  }
}