A horizontal progress bar component that visually represents the completion percentage of a task, with customizable colors and sizes.
Constructor Creates a new progress bar with 0% progress.
JProgressBar(double progress)
Creates a new progress bar with initial progress. Initial progress value (0.0 to 1.0)
ProgressStyle Defines the progress bar color:
PRIMARY - Primary color (default)SUCCESS - Green (success)DANGER - Red (error/critical)WARNING - Orange/yellow (warning)INFO - Blue (information)DARK - Dark graySECONDARY - Light gray
ProgressSize Defines the progress bar height:
SM - Small (.progress-sm)MD - Medium (.progress-md) - DefaultLG - Large (.progress-lg)
Methods setProgressStyle(ProgressStyle style)
Sets the progress bar color style. setSize(ProgressSize size)
Sets the progress bar size. The size to apply (SM, MD, or LG)
Inherited Methods from JavaFX ProgressBar setProgress(double value)
Sets the current progress value. Progress value: 0.0 (0%) to 1.0 (100%), or -1.0 for indeterminate
Gets the current progress value. Current progress (0.0 to 1.0, or -1.0 if indeterminate)
Returns the progress property for binding. Observable progress property
Usage Examples Basic Progress Bar JProgressBar progress = new JProgressBar (); progress . setProgress ( 0.5 ); // 50%
Styled Progress Bars // Success progress (green) JProgressBar successBar = new JProgressBar ( 0.8 ); successBar . setProgressStyle ( JProgressBar . ProgressStyle . SUCCESS ); // Danger progress (red) JProgressBar dangerBar = new JProgressBar ( 0.3 ); dangerBar . setProgressStyle ( JProgressBar . ProgressStyle . DANGER ); // Warning progress (orange) JProgressBar warningBar = new JProgressBar ( 0.6 ); warningBar . setProgressStyle ( JProgressBar . ProgressStyle . WARNING );
Different Sizes // Small JProgressBar smallBar = new JProgressBar (); smallBar . setSize ( JProgressBar . ProgressSize . SM ); smallBar . setProgress ( 0.4 ); // Large JProgressBar largeBar = new JProgressBar (); largeBar . setSize ( JProgressBar . ProgressSize . LG ); largeBar . setProgress ( 0.7 );
Indeterminate Progress // For tasks with unknown duration JProgressBar indeterminate = new JProgressBar (); indeterminate . setProgress ( - 1.0 ); // Indeterminate/loading state
Animated Progress JProgressBar progress = new JProgressBar ( 0.0 ); progress . setProgressStyle ( JProgressBar . ProgressStyle . PRIMARY ); // Simulate progress over time Timeline timeline = new Timeline ( new KeyFrame ( Duration . ZERO , new KeyValue ( progress . progressProperty (), 0 )), new KeyFrame ( Duration . seconds ( 5 ), new KeyValue ( progress . progressProperty (), 1.0 )) ); timeline . play ();
With Label VBox container = new VBox ( 8 ); JLabel label = new JLabel ( "Loading..." ); JProgressBar progress = new JProgressBar (); progress . progressProperty (). addListener ((obs, old, newVal) -> { int percent = ( int ) ( newVal . doubleValue () * 100 ); label . setText ( "Loading... " + percent + "%" ); }); container . getChildren (). addAll (label, progress);
File Upload Progress VBox uploadUI = new VBox ( 12 ); JLabel fileName = new JLabel ( "document.pdf" ); JProgressBar uploadProgress = new JProgressBar (); uploadProgress . setProgressStyle ( JProgressBar . ProgressStyle . INFO ); uploadUI . getChildren (). addAll (fileName, uploadProgress); // Update as upload progresses uploadFile (file, (bytesUploaded, totalBytes) -> { double progress = ( double ) bytesUploaded / totalBytes; uploadProgress . setProgress (progress); });
Style Classes
.j-progress-bar - Main progress bar.progress-primary - Primary color.progress-success - Success color.progress-danger - Danger color.progress-warning - Warning color.progress-info - Info color.progress-dark - Dark color.progress-secondary - Secondary color.progress-sm - Small size.progress-md - Medium size.progress-lg - Large size