Button Progress
El Button Progress es el Button en su modo progress: combina el botón interactivo con una barra de progreso integrada que le da al usuario retroalimentación en tiempo real mientras se ejecuta una operación crítica.
Previsualización Rápida
Section titled “Previsualización Rápida”Hacé clic en el botón para ver la animación completa. Para volver a verla, recargá la página.
Propósito
Section titled “Propósito”Mostrar el avance de una tarea que depende del tiempo de respuesta de un servicio cuando esa tarea ejecuta directamente un movimiento de dinero o la creación final de un instrumento financiero. La barra le confirma al usuario que su acción fue recibida y está en curso, y reduce la ansiedad y los reintentos en operaciones sensibles.
Anatomía del Componente
Section titled “Anatomía del Componente”- Background default: Fondo base del botón según su variante y color.
- Background progress: Relleno que avanza de izquierda a derecha dentro del botón. En la variante filled primaria usa el tono 7 de la paleta primaria.
- Icon left (opcional): Ícono decorativo que refuerza la acción.
- Label: Texto de acción. Cambia dinámicamente al iniciar el progreso.
- Icon right (opcional): Ícono decorativo ubicado a la derecha del label.
Comportamiento: las 2 etapas
Section titled “Comportamiento: las 2 etapas”- Inicialización:
- El botón muestra por defecto el texto de acción (ej: Continuar).
- La barra de progreso no es visible.
- Progreso:
- Al accionar el botón se activa un indicador visual que avanza dentro del botón.
- A medida que la acción avanza, la barra se completa y el texto cambia dinámicamente (ej: Procesando), brindando retroalimentación en tiempo real.
Animación
Section titled “Animación”- Duración: 3 segundos.
- Disparo: La animación se dispara después del clic del usuario.
- Progreso:
- El background progress llega a cubrir el 90% del botón y nunca el 100%. Así el usuario recibe feedback mientras se espera que el servicio responda.
- Al llegar al 90% el botón no reinicia su estado. Solo vuelve a su estado default si el usuario recarga la página, para evitar que lea que hay un proceso corriendo cuando no lo hay.
Estados de Interacción
Section titled “Estados de Interacción”- Default: Estado inicial. Muestra el label de acción y está disponible para ser presionado.
- Hover: Solo en la etapa de inicialización. El fondo se oscurece un tono para indicar que es interactivo.
- Focus: Mantiene un anillo de foco visible en navegación por teclado, también durante el progreso.
- En ejecución (Progress):
- El botón permanece visualmente en su estado progress (barra de fill). Nunca pasa a verse gris o apagado como disabled.
- El evento de acción se remueve: si el usuario intenta accionarlo mientras corre, no ejecuta nada.
- Se quita el feedback de hover y pressed, y el cursor deja de indicar una acción disponible.
- Disabled: Se usa solo antes de iniciar la acción (ej: formulario incompleto). No es un estado del proceso en curso.
Usos Recomendados y Guía de UX
Section titled “Usos Recomendados y Guía de UX”Cuándo usar
Section titled “Cuándo usar”Cuando la respuesta a esta pregunta es SÍ: ¿la acción ejecuta directamente un movimiento de dinero o la creación final de un instrumento financiero, y no un paso previo, una aprobación o una configuración del proceso?
- Transferencia
- Crear o cancelar plazo fijo
- Armar inversión
- Pagar tarjeta
- Ver CVV
- Solicitar préstamo
- Aceptar oferta preaprobada
- Contratar seguro
- Pagar impuesto o servicio
- Adherir a débito automático
Cuándo NO usar
Section titled “Cuándo NO usar”Si la respuesta es NO, usá el Button en modo loader. Aplica a acciones que esperan respuesta de un servicio pero son pasos previos, aprobaciones, configuraciones o ediciones:
- Validar OTP
- Bloquear tarjeta
- Guardar alias
- Guardar cambios en Drawer
- Aprobar o rechazar operación pendiente de firma
- Emitir o endosar ECHEQ
- Confirmar apertura de cuenta
- Cerrar sesión
- Editar datos de contacto o perfil
- Agregar o eliminar favorito de cuenta
- Descargar comprobante
- Activar o desactivar notificaciones
- Agregar firmante o autorizante
En caso de falla
Section titled “En caso de falla”- No vuelve a un estado de botón simple con label. Al ser una operación en curso, el error se resuelve dentro del flujo transaccional (ej: la pantalla de preticket mostrando el error de la operación), no como un cambio de estado del botón en la misma pantalla.
- No existe variante “Reintentar” en el label. El reintento se maneja en la pantalla de resultado del flujo, no en el botón.
Variantes / Opciones
Section titled “Variantes / Opciones”Label de progreso
Section titled “Label de progreso”El texto que reemplaza al label durante la ejecución se define para cada caso. Recomendamos describir la acción en curso con un verbo en gerundio (ej: Procesando) y respetar la regla de largo del Button: no más de 2 palabras y un conector.
Variantes y colores
Section titled “Variantes y colores”El Button Progress hereda las variantes, colores y tamaños del Button. El uso recomendado es filled primary en tamaño 2xl, ya que se trata de la acción principal que avanza en un flujo transaccional. En las variantes de menor jerarquía, la barra usa un tono claro de la misma paleta para mantener el contraste del label.
Pautas de Accesibilidad
Section titled “Pautas de Accesibilidad”Semántica
Section titled “Semántica”- Es un elemento semántico: se renderiza como un botón nativo y no requiere roles adicionales.
- Durante el progreso no se aplica disabled nativo, para que el foco no se pierda en medio del flujo.
Navegación por teclado
Section titled “Navegación por teclado”- Mantiene el foco visible en navegación con Tab, antes y durante el progreso.
- Se acciona con Enter o Space. Mientras corre, Enter y Space no disparan ninguna acción.
Lector de pantalla
Section titled “Lector de pantalla”- El cambio de label se anuncia de forma cortés (aria-live polite), sin interrumpir al usuario.
- El texto visible es el mismo que recibe el lector de pantalla, y se informa el nuevo label cuando cambia el estado.
- Mientras corre, el botón se marca como ocupado (aria-busy) para informar que hay un proceso en curso.
- Los íconos y la barra de progreso son decorativos y se ocultan para tecnologías asistivas.