Configuration rangeContainer

Specifies options of the gauge's range container.

Type: Object

In addition to the individual values indicated by needles, you can indicate different ranges on the scale. For instance, you can indicate the range of warm and cold temperatures in a circular gauge, which represents a thermometer. To set ranges, assign an array of objects defining the ranges to the ranges property of the rangeContainer configuration object. In addition, you can specify the orientation of the ranges relative to an invisible scale line, and an offset from this line using the rangeContainer properties.

backgroundColor

Specifies a range container's background color.

Type: String
Default Value: '#808080'

The background color is used to indicate the area reserved for the range container in the gauge. This color is replaced with the colors of the ranges contained in the range container.

This option supports the following colors.

  • Hexadecimal colors
  • RGB colors
  • RGBA colors (not supported in Internet Explorer 8)
  • Predefined/Cross-browser color names
  • Predefined SVG colors (not supported in Internet Explorer 8)

offset

Specifies the offset of the range container from an invisible scale line in pixels.

Type: Number
Default Value: 0

orientation

Specifies the orientation of the range container in the dxCircularGauge widget.

Type: String
Default Value: 'outside'
Accepted Values: 'outside' | 'center' | 'inside'

This property specifies the range container's orientation relative to an invisible scale line.
When setting up a range container, apply the required orientation first to check that the result responds to your needs. Then, set the required offset from the invisible scale line to shift the range container.

ranges[]

An array of objects representing ranges contained in the range container.

Type: Array
Default Value: []

Ranges allow you to mark certain value ranges in the gauge. Visually, the ranges are displayed as bars along scales. To define ranges, introduce the ranges array. Specify a start value, an end value and a color for each range.

width

Specifies the range container's width in pixels.

Type: Number
Default Value: 5