Page History

1. Introduction

This document is the user experience specification for JavaFX ProgressIndicator control.

2. Overview

Progress indicators are useful for communicating that a job is in-process. This feedback, at minimum, reassures the user that something is happening and, ideally, also lets the user know approximately how long the job will take to complete.

...

• Status Text - Below the progress bar a text string may be presented to describe details about the job. It may be used to indicate the percentage of job completion, with the estimations for time remaining. The text string can update and refresh dynamically.

Determinate Progress Bar

The Determinate Progress Bar provides feedback to the user that a job is in-process and indicates approximately how long it will take to complete. It should be used for a single measurable job composed of one or more steps.

...

Figure 2 Determinate Progress Bar (horizontal indicator, circular indicator, indication of finished job)

Indeterminate Progress Bar

The Indeterminate Progress Bar is used to provide feedback to the user that a job is in-process in the absence of measurable progress information. It should be used when there’s no way to accurately determine how long it will take a job to complete.

...

Figure 3 Indeterminate Progress Bar

Busy Indicator

The Busy Indicator is a simple animated graphic. It is used when no measurable progress can be reported. It is a not a bar, but a circular graphical indicator. Unlike the other progress indicators it can be used in contexts where space is constrained.

...

The Busy Indicator may be used as an inline ‘placeholder’ when data loading from the server affects the content presentation. For example, if redrawing a chart image causes a delay in repainting the screen, the busy indicator could be presented in the interim.

Error Message

A Dynamic Error Message may be presented when a job fails. If presented, the progress bar is dismissed and an inline error message takes its place. The error message consists of an error icon and associated error text. The intended use for this feature is for situations where only the progress bar itself is being presented to the user, such as in a table display. In other contexts alternate presentations may be preferable.

...