Skip to main content

🔘 Alpura Design System - Sistema de Botones

Esta documentación define el uso y la implementación de los botones para el Design System de Alpura, integrando Angular Material 19 con tokens de diseño personalizados.


📐 Escala de Tamaños​

Contamos con una escala amplia para adaptarnos a diferentes contextos de interfaz, desde tablas densas hasta landing pages.

ClaseAlturaFont SizeBorder RadiusUso Sugerido
.alp-btn-sm32px12px4pxTablas y espacios reducidos.
.alp-btn-md40px14px6pxTamaño estándar por defecto.
.alp-btn-lg44px16px8pxFormularios destacados.
.alp-btn-xl48px16px8pxModales y secciones amplias.
.alp-btn-2xl56px18px10pxCTAs principales.
.alp-btn-3xl64px20px12pxHero sections.

🎭 Jerarquías y Variantes​

Los botones se dividen por color de marca / funcionalidad y estilo visual (Solid, Ghost, Link).

1. Solid (Primary / Secondary / Tertiary / Quaternary)​

Utilizados para las acciones principales. Tienen un relleno sólido y cambian de tono en hover/active.

  • Primary: .alp-btn-primary-solid (Azul corporativo principales)
  • Secondary: .alp-btn-secondary-solid (Azul secundario)
  • Tertiary: .alp-btn-tertiary-solid (Morado acento)
  • Quaternary: .alp-btn-quaternary-solid (Rojo para acciones destructivas como "Eliminar")

2. Ghost (Delineados)​

Para acciones secundarias o de menor énfasis. Utilizan el color de la marca solo en el borde y texto, activando fondo "light" al hacer hover.

  • Clases: .alp-btn-[primary|secondary|tertiary|quaternary]-ghost
  • Comportamiento: Al hacer hover/focus, actualiza el borde y texto al tono de contraste correspondientes.

Utilizados para navegación o acciones discretas dentro de párrafos.

  • Clases: .alp-btn-[primary|secondary|tertiary|quaternary]-link
  • Visual: Texto subrayado que hereda el color seleccionado y remueve subrayado al hacer hover.

🏗️ Implementación en HTML​

Para asegurar la compatibilidad con Angular Material 19, se deben combinar las directivas de Material con nuestras clases de utilidad.

<!-- Botón Primario Estándar -->
<button mat-flat-button class="alp-btn-primary-solid alp-btn-md">
Confirmar
</button>

<!-- Botón Secundario Ghost -->
<button mat-stroked-button class="alp-btn-secondary-ghost alp-btn-lg">
Cancelar
</button>

<!-- Botón Cuaternario (Destructivo / Eliminar) -->
<button mat-flat-button class="alp-btn-quaternary-solid alp-btn-md">
<mat-icon>delete</mat-icon> Eliminar
</button>

<!-- Botón de Icono Circular Cuaternario -->
<button mat-flat-button class="alp-btn-quaternary-solid alp-btn-icon alp-btn-md" aria-label="Eliminar">
<mat-icon>delete</mat-icon>
</button>

<!-- Botón Tipo Enlace -->
<a mat-button class="alp-btn-quaternary-link" href="#">
Eliminar registro
</a>

🔘 Botones de Icono (.alp-btn-icon)​

Diseñados para ser perfectamente circulares y centrados numéricamente.

  • Requisito: Aplicar la clase .alp-btn-icon junto con una clase de tamaño (.alp-btn-sm, .alp-btn-md, .alp-btn-lg, etc.).
  • Padding: Reseteado estrictamente a 0 !important en todos los modificadores de tamaño para evitar desplazamientos por padding horizontal.
  • Centrado Interno: Anulación de márgenes por defecto de Angular Material MDC (mat-icon y .mdc-button__label) mediante flexbox centrado.
  • Escala de Ícono Proporcional:
    • .alp-btn-sm (32px): Ícono 18px
    • .alp-btn-md (40px): Ícono 20px
    • .alp-btn-lg (44px): Ícono 22px
    • .alp-btn-xl (48px): Ícono 24px
    • .alp-btn-2xl (56px): Ícono 28px
    • .alp-btn-3xl (64px): Ícono 32px

🚫 Estado Deshabilitado (:disabled)​

Conforme al nuevo estándar de Figma, los botones deshabilitados preservan la identidad cromática de su variante y aplican niveles de opacidad en lugar de un fondo gris plano:

  • Botones Solid e Iconos Solid: opacity: 0.4 (40%).
  • Botones Ghost, Link e Iconos Ghost: opacity: 0.5 (50%).
  • Cursor: not-allowed !important.
  • Sombra: none !important.

🛠️ Notas para Desarrolladores​

  • Transiciones: Todos los botones incluyen una transición suave de 0.2s ease-in-out para cambios de estado.
  • Especificidad: Se utilizan selectores MDC (Material Design Components) para asegurar que los estilos de Alpura sobrescriban los valores por defecto de Material.
  • Mixins: Si necesitas crear una variante nueva, utiliza los mixins internos:
    • @include alp-btn-solid-variant('nombre');
    • @include apply-alp-btn-size($alto, $font, $padding);
  • Tip: Priorizar la variante Quaternary (.alp-btn-quaternary-solid / .alp-btn-quaternary-ghost / .alp-btn-quaternary-link) para acciones irreversibles o destructivas como eliminar o dar de baja un registro.