Skip to content

Progress bar (progress polyfill)

LaurentGoderre edited this page Sep 14, 2012 · 16 revisions

français

Table of Contents

Background

Project Lead: Laurent Goderre(@LaurentGoderre)

Content from [[here | http://wet-boew.github.com/wet-boew/demos/datepicker/datepicker-eng.html ]] should be put below.  Please add content and include examples below.

Purpose

The HTML5 progress element allows to display the progress of a task. Because some browsers do not support this functionality natively, this polyfill emulates the same functionality using generic HTML and WAI-ARIA.

Rationale

Browsers that do not support the progress element natively ignore the progress bar and therefore, nothing is displayed and its content is not exposed to assistive technologies. This polyfill ensures that the progress is visually conveyed through a progress bar and exposed to assistive technologies by adding ARIA.

Implementation

To use the polyfill, a standard progress element must be used. In cases where browser don't support the progress element, the polyfill is automatically loaded.

Parameters/Options

The progress bar polyfill accepts two parameters: max and value. Neither of these parameters are required.

Value Parameter

This parameter represent the progress of the task and can be any decimal number between 0 and the max value. If value is omitted, the progress bar is considered to be undeterminate, which means that there is no indication on the actual progress of the task.

Max Parameter

This parameter represent the maximum progress for the task. When the value parameter is set to the maximum value, the task is considered complete. The max parameter can be any positive

Development

  • what do developers need to know?

Known Issues

  • list any known issues with the project here, and a reason for when this will be resolved or why it will not be

Future

  • what are the plans for this?
    • proposed changes
    • whats under-development
    • etc...

Version History

  • description
  • link to project commit descriptions

Related Pages

  • list of other pages inside wiki that are related to this article

References

  • list of external links relevant to this article
Clone this wiki locally