Skip to content

Button

El Button es el componente principal de interacción para desencadenar acciones directas, enviar formularios o confirmar pasos dentro de un flujo transaccional.



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.


  • 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).

  • 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ñ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.

¿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).

  1. 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: PreticketScreen mostrando el error).
    • No existe variante “Reintentar” dentro del botón.
  2. 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 Notification flotante, 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 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.

  1. Label: nombra la acción común de los ítems o, si son acciones distintas, dice “Más opciones”.
  2. Icon right (chevron): chevron hacia abajo que indica que el botón despliega un menú.
  • 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.
  • Í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.
  • 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.
  • 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.
  • 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.

  • 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-width definidos por tamaño.

  • Semántica HTML: Se renderiza siempre mediante un elemento semántico <button>.
  • Navegación por Teclado: Mantiene foco visible (Tab) e ingresa con Enter o Space.
  • Lectores de Pantalla: En modo loader, mientras está en ejecución, aplica aria-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 ni aria-disabled durante la ejecución, para que el usuario no pierda la posición de foco en medio de un flujo por teclado.
  • 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:
    • Enter o Space abre el menú y lleva el foco al primer ítem.
    • Las flechas ↑ y ↓ recorren los ítems.
    • Enter sobre un ítem ejecuta la acción y cierra el menú.
    • Esc cierra el menú y devuelve el foco al botón.
    • Tab con 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).

Para ordenar y combinar varios botones en el footer de una pantalla, consultá la documentación de ButtonsGroup.


El historial de cambios de todos los componentes de Monkey se registra en la Sheet de ChangeLog.