A widget that represents a gauge with a circular scale.

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

The dxCircularGauge widget allows you to present meaningful values on a numeric circular scale. The values can be displayed using different indicators such as needles, markers and range bars. In addition, different meaningful ranges can be highlighted on the scale.

The dxCircularGauge widget, like any other DevExtreme data visualization widget, can be created using one of the three possible approaches: jQuery, Knockout or AngularJS. The following code demonstrates how to create the dxCircularGauge widget within the "circularGaugeContainer" container using the jQuery approach.

  $(function () {
      //Options of the configuration object are specified here

To configure the dxCircularGauge widget, pass a configuration object as the constructor's parameter. The properties of this object represent the widget's configuration options. To specify the options, set the configuration object's properties to the required values. Refer to the Configuration section to find the options that are required to configure your circular gauge.

Start Tutorial View Demo Watch Video

See Also

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


An object that defines configuration options for the dxCircularGauge widget.


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


This section describes events fired by the widget.