ProgressBar
El componente ProgressBar representa visualmente el estado de finalización de una operación. A medida que avanza el trabajo, un rectángulo se llena gradualmente para reflejar el porcentaje actual. La barra también puede mostrar una representación textual de su valor y soporta tanto estados determinados como indeterminados para tareas con duración conocida o desconocida.
Usos
El componente ProgressBar es útil para visualizar el estado de finalización de las tareas. Soporta:
- Valores mínimos y máximos configurables.
- Modo indeterminado para tareas en curso sin un final definido.
- Opciones para la visibilidad del texto, animación y diseños a rayas para una mejor retroalimentación visual.
El siguiente ejemplo muestra una barra de progreso animada y a rayas con controles de inicio, pausa y reinicio:
Estableciendo valores
El componente ProgressBar permite establecer y obtener su valor actual, y los límites mínimo y máximo.
ProgressBar bar = new ProgressBar();
bar.setMin(0);
bar.setMax(100);
bar.setValue(50);
Orientación
El ProgressBar puede orientarse horizontal o verticalmente.
Estado indeterminado
El ProgressBar soporta un estado indeterminado para tareas con tiempo de finalización desconocido.
Texto y visibilidad del texto
Por defecto, al crearse, la barra de progreso muestra el porcentaje completo en el formato XX%. Usando el método setText(), puedes usar el marcador de posición {{x}} para obtener el valor actual como un porcentaje. Además, puedes usar el marcador de posición {{value}} para obtener el valor actual en bruto.
ProgressBar bar = new ProgressBar(15, "Descargando: {{x}}%");
Estilo
Temas
El componente ProgressBar viene con temas integrados para un estilo rápido sin el uso de CSS. Estos temas son estilos predefinidos que se pueden aplicar a los botones para cambiar su apariencia y presentación visual. Ofrecen una forma rápida y consistente de personalizar la apariencia de las ProgressBars en toda una aplicación.
Mejores prácticas
- Usar Valores Mínimos y Máximos Apropiados: Establecer los valores mínimo y máximo para reflejar con precisión el rango de la tarea.
- Actualizar Progreso Regularmente: Actualizar continuamente el valor del progreso para proporcionar retroalimentación en tiempo real a los usuarios.
- Utilizar Estado Indeterminado para Duraciones Desconocidas: Usar el estado indeterminado para tareas con duraciones impredecibles para indicar progreso en curso.
- Mostrar Texto para Mejorar la Retroalimentación del Usuario: Mostrar texto en la barra de progreso para ofrecer contexto adicional sobre el progreso de la tarea.
