Button
El Button es el componente principal de interacción para desencadenar acciones directas, enviar formularios o confirmar pasos dentro de un flujo transaccional.
Previsualización Rápida
Section titled “Previsualización Rápida”Propósito
Section titled “Propósito”Facilitar la ejecución de acciones claras e inequívocas en la interfaz. Orienta al usuario sobre la jerarquía del paso que está por realizar en la pantalla mediante variantes visuales y estados de avance.
Variantes y Jerarquía Visual (variant)
Section titled “Variantes y Jerarquía Visual (variant)”Filled - Botón de jerarquía primaria: Usá la acción filled para la acción principal de la pantalla. Debe existir idealmente un solo botón primario por vista para no confundir al usuario.Outline - Botón de jerarquía secundaria: Usá la acción outline para ofrecer alternativas a la acción principal o cuando ninguna de sus acciones sea más importante que las demás.Subtles - Botón de jerarquía terciaria: Usá la acción subtles para ofrecer alternativas de menor jerarquía o acciones complementarias no destructivas.White: Úsalo cuando el fondo necesite contraste o claridad adicional (ej: sobre tarjetas con fondos oscuros o banners de color).
Colores (color)
Section titled “Colores (color)”Primary: El botón predeterminado es el estándar y se utiliza para transmitir una acción general. Úsalo como opción principal en la mayoría de los casos.Destructive: Usá un estilo destructivo para acciones que tengan consecuencias irreversibles o críticas, como eliminar datos, cuentas o recursos importantes.
Tamaños (size)
Section titled “Tamaños (size)”| Tamaño | Alto | Ancho mínimo | Uso Sugerido | Soporte de Íconos |
|---|---|---|---|---|
2xl |
48px | 96px | Se utiliza para que los usuarios avancen en un flujo transaccional principal. | Izquierda y Derecha |
lg |
32px | 64px | Tamaño compacto. Ideal para botones de utilidad o menor jerarquía. | Izquierda y Derecha |
md |
24px | 64px | Utilizado en interfaces densas o dentro de tablas y herramientas en línea. | Izquierda y Derecha |
Modos de Ejecución y Estado de Espera (mode)
Section titled “Modos de Ejecución y Estado de Espera (mode)”Default: Botón estándar. Ejecuta la acción de forma directa sin estado de espera propio.Loader: Para acciones que esperan respuesta de servicio y NO ejecutan movimiento de dinero (ej: validar OTP, bloquear tarjeta, guardar alias, cambiar contraseña). Muestra su label hasta que se presiona; durante la ejecución reemplaza la etiqueta e íconos por puntos animados, sin cambiar el tamaño del botón, y no responde a un segundo toque.Progress: Para acciones que SÍ ejecutan directamente un movimiento de dinero o la creación final de un instrumento financiero (ej: transferencias, constituir plazo fijo, pagar tarjeta, contratar seguro). Muestra una barra de fill que avanza hasta el 90% y cambia el label durante la ejecución.
Guía de UX: Progress vs Loader
Section titled “Guía de UX: Progress vs Loader”¿Cuándo usar cada uno?
Section titled “¿Cuándo usar cada uno?”¿La acción ejecuta directamente un movimiento de dinero o la creación final de un instrumento financiero?
- SÍ $\rightarrow$ Button Progress (Transferencia, Plazo Fijo, Pagar Tarjeta, Solicitar Préstamo, Ver CVV).
- NO $\rightarrow$ Button Loader (Validar OTP, Bloquear Tarjeta, Guardar Alias, Cerrar Sesión, Editar Perfil).
Comportamiento en caso de Falla o Error
Section titled “Comportamiento en caso de Falla o Error”-
En Button Progress:
- No vuelve a un estado de botón simple con label en la misma pantalla.
- Al ser una operación en curso, el error se resuelve dentro del flujo transaccional en la pantalla de resultado (ej:
PreticketScreenmostrando el error). - No existe variante “Reintentar” dentro del botón.
-
En Button Loader:
- El botón vuelve a mostrar su Label original y vuelve a ser accionable.
- El usuario debe ser notificado del error mediante un componente de
Notificationflotante, nunca mediante cambios de label o alertas dentro del mismo botón. - Si el error se detecta antes de consultar el servicio (por ejemplo, un campo incompleto), el botón vuelve a su label en el mismo momento y el error se muestra en el campo correspondiente.
Button con chevron
Section titled “Button con chevron”Button con un chevron en el ícono derecho que, al presionarlo, despliega un Menu. El botón no ejecuta ninguna acción propia: solo abre el menú, y cada ítem del menú ejecuta una acción.
Anatomía
Section titled “Anatomía”- Label: nombra la acción común de los ítems o, si son acciones distintas, dice “Más opciones”.
- Icon right (chevron): chevron hacia abajo que indica que el botón despliega un menú.
Reglas
Section titled “Reglas”- Si el botón tiene chevron, debe desplegar un Menu. Si no despliega un Menu, no lleva chevron.
- El chevron hacia abajo no se usa como decoración ni para indicar navegación.
- El menú lleva como mínimo 2 ítems y como máximo 4.
- Cada ítem ejecuta una acción.
- El chevron ocupa el ícono derecho. No se combina con ícono izquierdo.
- El chevron es estático: no rota ni cambia al abrir el menú.
- Solo funciona en modo default: no usa Loader ni Progress.
Cómo nombrar el label
Section titled “Cómo nombrar el label”- Ítems del mismo tipo de acción: el label nombra esa acción. Por ejemplo, “Comprobante de solicitud” y “Comprobante de liquidación” se agrupan como Descargar comprobantes.
- Ítems con acciones distintas: el label es Más opciones. Por ejemplo: descargar, ver detalle, ver comprobantes y autorizar.
No usar
Section titled “No usar”- Una sola acción: usá un Button sin chevron.
- Elegir un valor que queda mostrado en el campo: usá SelectField.
- Expandir o colapsar contenido: usá Accordion.
Interacción
Section titled “Interacción”- Presionar el botón abre el menú.
- Presionar un ítem ejecuta su acción y cierra el menú.
- Presionar fuera del menú lo cierra sin ejecutar nada.
- Puede usarse dentro de cualquier componente.
Ubicación y apertura
Section titled “Ubicación y apertura”- El menú se abre como Menu tanto en Desktop como en Mobile. Es una excepción al comportamiento de apertura general, que en mobile usa drawer.
- Se despliega por debajo del botón, a 8px, y se reacomoda por encima o alineado a la derecha si no tiene espacio.
- Su ancho mínimo es el del botón.
Adaptabilidad en Dispositivos Móviles
Section titled “Adaptabilidad en Dispositivos Móviles”- En dispositivos móviles, el botón se ajusta automáticamente para ocupar el 100% del ancho disponible (full-width) para mejorar la visibilidad y facilitar la interacción táctil.
- En escritorio (Desktop), el ancho se ajusta automáticamente al contenido de su etiqueta (hug label), respetando sus valores de
min-widthdefinidos por tamaño.
Pautas de Accesibilidad
Section titled “Pautas de Accesibilidad”- Semántica HTML: Se renderiza siempre mediante un elemento semántico
<button>. - Navegación por Teclado: Mantiene foco visible (
Tab) e ingresa conEnteroSpace. - Lectores de Pantalla: En modo
loader, mientras está en ejecución, aplicaaria-busy="true"y el nombre accesible pasa a un valor explícito de proceso (ej: Guardando cambios, procesando); al volver a su estado inicial recupera su nombre original.* Foco en Loader y Progress: No se aplica disabled nativo niaria-disableddurante la ejecución, para que el usuario no pierda la posición de foco en medio de un flujo por teclado.
Button con chevron
Section titled “Button con chevron”- Semántica: se renderiza como un elemento semántico de botón y anuncia que abre un menú. El estado abierto o cerrado se comunica al lector de pantalla con el atributo de expansión, no solo de forma visual (WCAG 1.4.1).
- Navegación por teclado:
EnteroSpaceabre el menú y lleva el foco al primer ítem.- Las flechas
↑y↓recorren los ítems. Entersobre un ítem ejecuta la acción y cierra el menú.Esccierra el menú y devuelve el foco al botón.Tabcon el menú abierto cierra el menú.
- Varios “Más opciones” en la misma pantalla: cada uno lleva un nombre accesible que lo distinga, por ejemplo Más opciones del movimiento (WCAG 2.4.6).
Posiciones de botones en el footer
Section titled “Posiciones de botones en el footer”Para ordenar y combinar varios botones en el footer de una pantalla, consultá la documentación de ButtonsGroup.
ChangeLog
Section titled “ChangeLog”El historial de cambios de todos los componentes de Monkey se registra en la Sheet de ChangeLog.