Kendo UI for jQuery ProgressBar Overview

The ProgressBar delivers rich functionality for displaying and tracking the progress of a task.

To see the ProgressBar in action, visit its demo page.

The component provides the following types:

Kendo UI for jQuery Kendoka image

The ProgressBar is part of Kendo UI for jQuery, a professional grade UI library with 110+ components for building modern and feature-rich applications. To try it out sign up for a free 30-day trial.

  • value—Represents a regular ProgressBar which displays the progress status as an absolute value.
  • percent—Represents a regular ProgressBar which displays the progress status in percentage.
  • chunk—Represents a ProgressBar which is divided in chunks and displays the progress status in steps.

The ProgressBar also supports horizontal and vertical orientation, reversed direction, minimum and maximum values, and animation duration.

Basic Configuration

The following example demonstrates how to create the ProgressBar by using a <div> element.

<div id="progressbar"></div>

The following example demonstrates how to initialize the ProgressBar by using a jQuery selector.

$(document).ready(function(){
  $("#progressbar").kendoProgressBar();
});

The following example demonstrates how to initialize a chunk ProgressBar.

<div id="progressbar"></div>
<script>
  $("#progressbar").kendoProgressBar({
    type: "chunk",
    chunkCount: 10
  });
</script>

The following example demonstrates how to configure the basic properties of the ProgressBar.

$("#progressbar").kendoProgressBar({
  min: 100,
  max: 500,
  value: 100,
  type: "percent",
  orientation: "vertical",
  reverse: true,
  complete: function(e) {
    console.log("Progress completed");
  },
  animation: {
    duration: 600
  }
});

Functionality and Features

You can set the appearance of the ProgressBar.

Events

The ProgressBar supports the change and complete events. change fires each time a new value is set. complete fires when the progress of the task is completed, that is, each time the ProgressBar reaches its maximum value.

To handle these events, you can specify the JavaScript function which will handle the event during the initialization of the component or use the bind method of the component after its initialization.

For a runnable example, refer to the demo on using the events of the ProgressBar.

Referencing Existing Instances

Make a reference to an existing ProgressBar instance through jQuery.data() and use the ProgressBar API to control its behavior.

The following example demonstrates how to access an existing ProgressBar instance.

var progressbar = $("#progressbar").data("kendoProgressBar");

See Also

In this article