Main content

progressbar

Characteristics

Superclass Role:

  • range

Related Concepts:

  • status

Inherited States and Properties:

  • aria-atomic
  • aria-busy (state)
  • aria-controls
  • aria-describedby
  • aria-disabled (state)
  • aria-dropeffect
  • aria-flowto
  • aria-grabbed (state)
  • aria-haspopup
  • aria-hidden (state)
  • aria-invalid (state)
  • aria-label
  • aria-labelledby
  • aria-live
  • aria-owns
  • aria-relevant
  • aria-valuemax
  • aria-valuemin
  • aria-valuenow
  • aria-valuetext

Name From:

  • author

Accessible Name Required:

  • True

Children Presentational:

  • True

Implicit Value for Role:

  • Default for aria-readonly is true

An element that displays the progress status for tasks that take a long time.

A progressbar (role) is assigned to the portion of the page that displays the status of a lengthy task. A progress bar indicates that the user's request is received and is in the process of executing the task. Content authors should provide values of aria-valumin, aria-valuemax and aria-valuenow where the aria-valuemax is known. All these values should be updated when the visual content gets updated. The user should be provided with the current status using aria-valuenow. 

Eg: When a file of 100 mb is downloaded, a progressbar indicates aria-valuemin as 0, aria-valuemax as 100 and aria-valuenow with the current status of the download.

If the progressbar is describing the loading progress of a particular region of a page, the author should use aria-describedby to point to the status, and set the aria-busy attribute to true on the region until it is finished loading. It is not possible for the user to alter the value of a progressbar because it is always readonly. 

Note: Assistive technologies generally will render the value of aria-valuenow as a percent of the range between the value of aria-valuemin and aria-valuemax, unlessaria-valuetext is specified. It is best to set the values for aria-valuemin, aria-valuemax, and aria-valuenow in a manner that is appropriate for this calculation.

Microsoft Active Accessibility accRole Property: 

  • ROLE_SYSTEM_PROGRESSBAR

UI Automation ControlType Property: 

  • ProgressBar

UI Automation AriaRole Property: 

  • progressbar
More in this category: « radio presentation »