Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


The Material Design Lite (MDL) progress component is a visual indicator of background activity in a web page or application. A progress indicator consists of a (typically) horizontal bar containing some animation that conveys a sense of motion. While some progress devices indicate an approximate or specific percentage of completion, the MDL progress component simply communicates the fact that an activity is ongoing and is not yet complete.

Progress indicators are an established but non-standardized feature in user interfaces, and provide users with a visual clue to an application's status. Their design and use is therefore an important factor in the overall user experience. See the progress component's Material Design specifications page for details.

Basic use

To use any MDL component, you must include the minified CSS and JavaScript files using standard relative-path references in the <head> section of the page, as described in the MDL Introduction.

To include an MDL progress component:

 1. Code a <div> element. Include any desired attributes and values, such as an id or width — typically done using external CSS rather than the inline style attribute as shown here.

<div id="prog1" style="width:250px"></div>

 2. Add one or more MDL classes, separated by spaces, to the div using the class attribute.

<div id="prog1" style="width:250px" class="mdl-js-progress"></div>

The progress component is ready for use.


A static (non-animated) progress indicator.

<div id="progstatic" style="width:250px" class="mdl-js-progress"></div>

An active (animated) progress indicator.

<div id="progactive" style="width:200px" class="mdl-js-progress

Configuration options

The MDL CSS classes apply various predefined visual and behavioral enhancements to the progress indicator. The table below lists the available classes and their effects.

MDL class Effect Remarks
mdl-js-progress Assigns basic MDL behavior to progress indicator Required
mdl-progress__indeterminate Applies animation effect Optional