🔘 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.
| Clase | Altura | Font Size | Border Radius | Uso Sugerido |
|---|---|---|---|---|
.alp-btn-sm | 32px | 12px | 4px | Tablas y espacios reducidos. |
.alp-btn-md | 40px | 14px | 6px | Tamaño estándar por defecto. |
.alp-btn-lg | 44px | 16px | 8px | Formularios destacados. |
.alp-btn-xl | 48px | 16px | 8px | Modales y secciones amplias. |
.alp-btn-2xl | 56px | 18px | 10px | CTAs principales. |
.alp-btn-3xl | 64px | 20px | 12px | Hero 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.
3. Link (Estilo Texto)
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-iconjunto con una clase de tamaño (.alp-btn-sm,.alp-btn-md,.alp-btn-lg, etc.). - Padding: Reseteado estrictamente a
0 !importanten 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-icony.mdc-button__label) mediante flexbox centrado. - Escala de Ícono Proporcional:
.alp-btn-sm(32px): Ícono18px.alp-btn-md(40px): Ícono20px.alp-btn-lg(44px): Ícono22px.alp-btn-xl(48px): Ícono24px.alp-btn-2xl(56px): Ícono28px.alp-btn-3xl(64px): Ícono32px
🚫 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-outpara 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.