Data Visualization Widgets BarGauge

A circular bar widget.

Included in: dx.chartjs.js, dx.all.js

The dxBarGauge widget represents data as a set of bars. Each bar resides on a separate circular track and indicates one value. That bar is accompanied by a label displaying the indicated value.

You can create a widget using one of the following approaches.

  • jQuery
    Use the dxBarGauge jQuery plug-in.

    HTML
    <div id="gaugeContainer"></div>
    JavaScript
    $("#gaugeContainer").dxBarGauge({
        startValue: 0,
        endValue: 100,
        values: [21.3, 54.1, 30.9, 45.2, 89.41]
    });
  • Knockout
    Add a div element and apply the dxBarGauge binding to this element.

    HTML
    <div data-bind="dxBarGauge: {
        startValue: 0,
        endValue: 100,
        values: [21.3, 54.1, 30.9, 45.2, 89.41]
    }"></div>
  • Angular
    Add a div element and apply the dx-bar-gauge directive to this element.

    HTML
    <div dx-bar-gauge="{
        startValue: 0,
        endValue: 100,
        values: [21.3, 54.1, 30.9, 45.2, 89.41]
    }"></div>

Note that DevExtreme widgets require you to link the jQuery and Globalize libraries to your application. If you use the Knockout or Angular approach, the Knockout or Angular library is also required. For detailed information on creating widgets, refer to the Create a Widget article.

Start Tutorial View Demo Watch Video

See Also

To learn about widget concepts and overview features, refer to the Gauges section within the Data Visualization Guides.

Configuration

An object that defines configuration options for the dxBarGauge widget.

Methods

This section describes the methods that can be used in code to manipulate objects related to the dxBarGauge widget.

Events

This section describes events exposed by this widget.

To handle events, use one of the following methods.

  • Attach a handler to a widget option
    Assign a callback function to the widget option that takes on a handler for the required event. The events that can be handled within the widget's configuration object are listed in the Configuration section. All these events have names starting with on.

  • Attach several handlers for one or several events to a widget
    Specify event handling functions for one or more events using the on() method. All the widget events are listed in the Events section.