ProgressBar
Le composant ProgressBar représente visuellement l'état d'achèvement d'une opération. Au fur et à mesure que le travail progresse, un rectangle se remplit progressivement pour refléter le pourcentage actuel. La barre peut également afficher une représentation textuelle de sa valeur et prend en charge à la fois les états déterminés et indéterminés pour les tâches de durée connue ou inconnue.
Usages
Le composant ProgressBar est utile pour visualiser l'état d'achèvement des tâches. Il prend en charge :
- Des valeurs minimum et maximum configurables.
- Un mode indéterminé pour les tâches en cours sans fin définie.
- Des options pour la visibilité du texte, l'animation et des designs rayés pour un meilleur retour visuel.
L'exemple suivant montre une barre de progression rayée et animée avec des contrôles de démarrage, de pause et de réinitialisation :
Afficher le code
- Java
Définir des valeurs
Le composant ProgressBar permet de définir et d'obtenir sa valeur actuelle, ses limites minimales et maximales.
ProgressBar bar = new ProgressBar();
bar.setMin(0);
bar.setMax(100);
bar.setValue(50);
Orientation
Le ProgressBar peut être orienté horizontalement ou verticalement.
Afficher le code
- Java
État indéterminé
Le ProgressBar prend en charge un état indéterminé pour les tâches dont le temps d'achèvement est inconnu.
Afficher le code
- Java
Texte et visibilité du texte
Par défaut, lors de sa création, la barre de progression affiche le pourcentage d'achèvement au format XX%. En utilisant la méthode setText(), vous pouvez utiliser le placeholder {{x}} pour obtenir la valeur actuelle en pourcentage. De plus, vous pouvez utiliser le placeholder
{{value}} pour obtenir la valeur brute actuelle.
ProgressBar bar = new ProgressBar(15, "Téléchargement : {{x}}%");
Stylisation
Thèmes
Le composant ProgressBar est livré avec des thèmes intégrés pour un style rapide sans utiliser de CSS. Ces thèmes sont des styles prédéfinis qui peuvent être appliqués aux boutons pour modifier leur apparence et leur présentation visuelle.
Ils offrent un moyen rapide et cohérent de personnaliser l'apparence des ProgressBars dans toute l'application.
Afficher le code
- Java
Meilleures pratiques
- Utilisez des valeurs minimales et maximales appropriées : Définissez les valeurs minimales et maximales pour refléter avec précision l'étendue de la tâche.
- Mettez à jour régulièrement les progrès : Mettez continuellement à jour la valeur de progression pour fournir un retour en temps réel aux utilisateurs.
- Utilisez l'état indéterminé pour des durées inconnues : Utilisez l'état indéterminé pour les tâches dont les durées sont imprévisibles afin d'indiquer un progrès en cours.
- Affichez du texte pour un meilleur retour d'utilisateur : Affichez du texte sur la barre de progression pour offrir un contexte supplémentaire sur l'état d'avancement de la tâche.