React

Search results

Ranges in React Circular Gauge component

17 Sep 2021 / 6 minutes to read

You can categories certain interval on gauge axis using ranges property.

Start and End

Start and end value of a range in an axis can be customized by using start and end properties.

Source

Preview

index.tsx

index.jsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import { CircularGaugeComponent, AxesDirective, AxisDirective, RangesDirective, RangeDirective } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(
  <CircularGaugeComponent id='circulargauge'>
    <AxesDirective>
      <AxisDirective>
        <RangesDirective>
            <RangeDirective start = {40} end = {80}></RangeDirective>
        </RangesDirective>
      </AxisDirective>
    </AxesDirective>
  </CircularGaugeComponent>,document.getElementById('circulargauge'));

import * as React from "react";
import * as ReactDOM from "react-dom";
import { CircularGaugeComponent, AxesDirective, AxisDirective, RangesDirective, RangeDirective } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(<CircularGaugeComponent id='circulargauge'>
    <AxesDirective>
      <AxisDirective>
        <RangesDirective>
            <RangeDirective start={40} end={80}></RangeDirective>
        </RangesDirective>
      </AxisDirective>
    </AxesDirective>
  </CircularGaugeComponent>, document.getElementById('circulargauge'));

Customization

Color and thickness of the range can be customized by using color, startWidth and endWidth property.

Source

Preview

index.tsx

index.jsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import { CircularGaugeComponent, AxesDirective, AxisDirective, RangesDirective, RangeDirective } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(
  <CircularGaugeComponent id='circulargauge'>
    <AxesDirective>
      <AxisDirective>
        <RangesDirective>
            <RangeDirective start = {40} end = {80} startWidth = {15} endWidth = {15}
            color = '#ff5985'></RangeDirective>
        </RangesDirective>
      </AxisDirective>
    </AxesDirective>
  </CircularGaugeComponent>,document.getElementById('circulargauge'));

import * as React from "react";
import * as ReactDOM from "react-dom";
import { CircularGaugeComponent, AxesDirective, AxisDirective, RangesDirective, RangeDirective } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(<CircularGaugeComponent id='circulargauge'>
    <AxesDirective>
      <AxisDirective>
        <RangesDirective>
            <RangeDirective start={40} end={80} startWidth={15} endWidth={15} color='#ff5985'></RangeDirective>
        </RangesDirective>
      </AxisDirective>
    </AxesDirective>
  </CircularGaugeComponent>, document.getElementById('circulargauge'));

Radius

You can place the range inside or outside of the axis by using radius property. The radius of the range can takes value either in percentage or in pixels. By default, ranges take 100% of the axis radius.

In Pixel

You can set the radius of the range in pixel as demonstrated below,

Source

Preview

index.tsx

index.jsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import { CircularGaugeComponent, AxesDirective, AxisDirective, RangesDirective, RangeDirective } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(
  <CircularGaugeComponent id='circulargauge'>
    <AxesDirective>
      <AxisDirective>
        <RangesDirective>
            <RangeDirective start = {40} end = {80} radius = '100'></RangeDirective>
        </RangesDirective>
      </AxisDirective>
    </AxesDirective>
  </CircularGaugeComponent>,document.getElementById('circulargauge'));

import * as React from "react";
import * as ReactDOM from "react-dom";
import { CircularGaugeComponent, AxesDirective, AxisDirective, RangesDirective, RangeDirective } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(<CircularGaugeComponent id='circulargauge'>
    <AxesDirective>
      <AxisDirective>
        <RangesDirective>
            <RangeDirective start={40} end={80} radius='100'></RangeDirective>
        </RangesDirective>
      </AxisDirective>
    </AxesDirective>
  </CircularGaugeComponent>, document.getElementById('circulargauge'));

In Percentage

By setting value in percentage, range gets its dimension with respect to its axis radius. For example, when the radius is ‘50%’, range renders to half of the axis radius.

Source

Preview

index.tsx

index.jsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import { CircularGaugeComponent, AxesDirective, AxisDirective, RangesDirective, RangeDirective } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(
  <CircularGaugeComponent id='circulargauge'>
    <AxesDirective>
      <AxisDirective>
        <RangesDirective>
            <RangeDirective start = {40} end = {80} radius = '50%'></RangeDirective>
        </RangesDirective>
      </AxisDirective>
    </AxesDirective>
  </CircularGaugeComponent>,document.getElementById('circulargauge'));

import * as React from "react";
import * as ReactDOM from "react-dom";
import { CircularGaugeComponent, AxesDirective, AxisDirective, RangesDirective, RangeDirective } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(<CircularGaugeComponent id='circulargauge'>
    <AxesDirective>
      <AxisDirective>
        <RangesDirective>
            <RangeDirective start={40} end={80} radius='50%'></RangeDirective>
        </RangesDirective>
      </AxisDirective>
    </AxesDirective>
  </CircularGaugeComponent>, document.getElementById('circulargauge'));

Dragging range

The ranges can be dragged on the axis values by clicking and dragging the same. To enable or disable the range drag, use the enableRangeDrag property.

Source

Preview

index.tsx

index.jsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import { CircularGaugeComponent, AxesDirective, AxisDirective, PointersDirective, PointerDirective,
RangesDirective, RangeDirective } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(
  <CircularGaugeComponent id='circulargauge' enableRangeDrag={true} height='250px' width='250px'>
    <AxesDirective>
      <AxisDirective>
        <RangesDirective>
            <RangeDirective start = {0} end = {100} startWidth={8} endWidth={8} radius='108%' color='#30B32D'></RangeDirective>
        </RangesDirective>
        <PointersDirective>
            <PointerDirective value = {50}></PointerDirective>
        </PointersDirective>
      </AxisDirective>
    </AxesDirective>
  </CircularGaugeComponent>,document.getElementById('circulargauge'));

import * as React from "react";
import * as ReactDOM from "react-dom";
import { CircularGaugeComponent, AxesDirective, AxisDirective, PointersDirective, PointerDirective, RangesDirective, RangeDirective } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(<CircularGaugeComponent id='circulargauge' enableRangeDrag={true} height='250px' width='250px'>
    <AxesDirective>
      <AxisDirective>
        <RangesDirective>
            <RangeDirective start={0} end={100} startWidth={8} endWidth={8} radius='108%' color='#30B32D'></RangeDirective>
        </RangesDirective>
        <PointersDirective>
            <PointerDirective value={50}></PointerDirective>
        </PointersDirective>
      </AxisDirective>
    </AxesDirective>
  </CircularGaugeComponent>, document.getElementById('circulargauge'));

Multiple Ranges

You can add multiple ranges to an axis with the above customization as demonstrated below.

Note: You can set the range color to axis ticks and labels by enabling useRangeColor property in majorTicks, minorTicks and labelStyle object.

Source

Preview

index.tsx

index.jsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import { CircularGaugeComponent, AxesDirective, AxisDirective, RangesDirective, RangeDirective } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(
  <CircularGaugeComponent id='circulargauge'>
    <AxesDirective>
      <AxisDirective majorTicks = {{ useRangeColor: true }} minorTicks = {{ useRangeColor: true }} labelStyle = {{ useRangeColor: true }}>
        <RangesDirective>
            <RangeDirective start = {0} end = {25} radius = '108%'></RangeDirective>
            <RangeDirective start = {25} end = {50} radius = '70%'></RangeDirective>
            <RangeDirective start = {50} end = {75} radius = '70%'></RangeDirective>
            <RangeDirective start = {75} end = {100} radius = '108%'></RangeDirective>
        </RangesDirective>
      </AxisDirective>
    </AxesDirective>
  </CircularGaugeComponent>,document.getElementById('circulargauge'));

import * as React from "react";
import * as ReactDOM from "react-dom";
import { CircularGaugeComponent, AxesDirective, AxisDirective, RangesDirective, RangeDirective } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(<CircularGaugeComponent id='circulargauge'>
    <AxesDirective>
      <AxisDirective majorTicks={{ useRangeColor: true }} minorTicks={{ useRangeColor: true }} labelStyle={{ useRangeColor: true }}>
        <RangesDirective>
            <RangeDirective start={0} end={25} radius='108%'></RangeDirective>
            <RangeDirective start={25} end={50} radius='70%'></RangeDirective>
            <RangeDirective start={50} end={75} radius='70%'></RangeDirective>
            <RangeDirective start={75} end={100} radius='108%'></RangeDirective>
        </RangesDirective>
      </AxisDirective>
    </AxesDirective>
  </CircularGaugeComponent>, document.getElementById('circulargauge'));

Rounded corner radius

You can customize the corner radius using the roundedCornerRadius property in ranges.

Source

Preview

index.tsx

index.jsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import { CircularGaugeComponent, AxesDirective, AxisDirective, RangesDirective, RangeDirective } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(
  <CircularGaugeComponent id='circulargauge'>
    <AxesDirective>
      <AxisDirective>
        <RangesDirective>
            <RangeDirective start = {40} end = {80} radius = '50%' roundedCornerRadius = {5}></RangeDirective>
        </RangesDirective>
      </AxisDirective>
    </AxesDirective>
  </CircularGaugeComponent>,document.getElementById('circulargauge'));

import * as React from "react";
import * as ReactDOM from "react-dom";
import { CircularGaugeComponent, AxesDirective, AxisDirective, RangesDirective, RangeDirective } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(<CircularGaugeComponent id='circulargauge'>
    <AxesDirective>
      <AxisDirective>
        <RangesDirective>
            <RangeDirective start={40} end={80} radius='50%' roundedCornerRadius={5}></RangeDirective>
        </RangesDirective>
      </AxisDirective>
    </AxesDirective>
  </CircularGaugeComponent>, document.getElementById('circulargauge'));

Gradient Color

Gradient support allows to add multiple colors in the ranges and pointers of the circular gauge. The following gradient types are supported in the circular gauge.

Linear Gradient
Radial Gradient

Linear Gradient

Using linear gradient, colors will be applied in a linear progression. The start value of the linear gradient can be set using the startValue property. The end value of the linear gradient will be set using the endValue property. The color stop values such as color, opacity and offset are set using colorStop property.

To apply linear gradient to the range, follow the below code sample.

Source

Preview

index.tsx

index.jsx

import * as React from 'react';
import * as ReactDOM from 'react-dom';
import { CircularGaugeComponent, RangesDirective, RangeDirective, AxesDirective, AxisDirective, PointersDirective, PointerDirective, Inject, Gradient} from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(
  <CircularGaugeComponent>
<Inject services={[Gradient]} />
<AxesDirective>
  <AxisDirective radius="80%" startAngle={200} endAngle={160} minimum={0} maximum={100}
                 lineStyle={{ width: 0 }}
                 labelStyle={{
                     font: {
                         fontWeight: 'Roboto',
                         fontStyle: 'Regular',
                         size: '0px',
                         color: 'white'
                      },
                 position: 'Inside',
                 useRangeColor: true
    }}
    majorTicks={{ height: 0 }}
    minorTicks={{ height: 0 }}>
    <RangesDirective>
      <RangeDirective start={0} end={120} radius="90%" startWidth={30} endWidth={30}
                      roundedCornerRadius={20}
                      linearGradient={{
                          startValue: '0%',
                          endValue: '100%',
                          colorStop: [
                              { color: '#9E40DC', offset: '0%', opacity: 0.9 },
                               { color: '#E63B86', offset: '70%', opacity: 0.9 }
                          ]
                      }}/>
    </RangesDirective>
    <PointersDirective>
      <PointerDirective pointerWidth={0} cap={{ radius: '0' }} />
    </PointersDirective>
  </AxisDirective>
</AxesDirective>
  </CircularGaugeComponent>,
  document.getElementById('circulargauge')
);

import * as React from 'react';
import * as ReactDOM from 'react-dom';
import { CircularGaugeComponent, RangesDirective, RangeDirective, AxesDirective, AxisDirective, PointersDirective, PointerDirective, Inject, Gradient } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(<CircularGaugeComponent>
<Inject services={[Gradient]}/>
<AxesDirective>
  <AxisDirective radius="80%" startAngle={200} endAngle={160} minimum={0} maximum={100} lineStyle={{ width: 0 }} labelStyle={{
    font: {
        fontWeight: 'Roboto',
        fontStyle: 'Regular',
        size: '0px',
        color: 'white'
    },
    position: 'Inside',
    useRangeColor: true
}} majorTicks={{ height: 0 }} minorTicks={{ height: 0 }}>
    <RangesDirective>
      <RangeDirective start={0} end={120} radius="90%" startWidth={30} endWidth={30} roundedCornerRadius={20} linearGradient={{
    startValue: '0%',
    endValue: '100%',
    colorStop: [
        { color: '#9E40DC', offset: '0%', opacity: 0.9 },
        { color: '#E63B86', offset: '70%', opacity: 0.9 }
    ]
}}/>
    </RangesDirective>
    <PointersDirective>
      <PointerDirective pointerWidth={0} cap={{ radius: '0' }}/>
    </PointersDirective>
  </AxisDirective>
</AxesDirective>
  </CircularGaugeComponent>, document.getElementById('circulargauge'));

Radial Gradient

Using radial gradient, colors will be applied in circular progression. The inner circle position of the radial gradient will be set using the innerPosition property. The outer circle position of the radial gradient can be set using the outerPosition property. The color stop values such as color, opacity and offset are set using colorStop property.

To apply radial gradient to the range, follow the below code sample.

Source

Preview

index.tsx

index.jsx

import * as React from 'react';
import * as ReactDOM from 'react-dom';
import { CircularGaugeComponent, RangesDirective, RangeDirective, AxesDirective, AxisDirective, PointersDirective, PointerDirective, Inject, Gradient } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(
  <CircularGaugeComponent>
<Inject services={[Gradient]} />
<AxesDirective>
  <AxisDirective radius="80%" startAngle={200} endAngle={160} minimum={0} maximum={100}
                 lineStyle={{ width: 0 }}
                 labelStyle={{
                     font: {
                         fontWeight: 'Roboto',
                         fontStyle: 'Regular',
                         size: '0px',
                         color: 'white'
                     },
                 position: 'Inside',
                 useRangeColor: true
                }}
                majorTicks={{ height: 0 }}
                minorTicks={{ height: 0 }}>
    <RangesDirective>
      <RangeDirective start={0} end={120} radius="90%" startWidth={30} endWidth={30}
                      roundedCornerRadius={20}
                      radialGradient={{
                          radius: '50%',
                          innerPosition: { x: '50%', y: '50%' },
                          outerPosition: { x: '50%', y: '50%' },
                          colorStop: [
                              { color: '#9E40DC', offset: '90%', opacity: 0.9 },
                              { color: '#E63B86', offset: '160%', opacity: 0.9 }
                          ]
                      }}/>
    </RangesDirective>
    <PointersDirective>
      <PointerDirective pointerWidth={0} cap={{ radius: '0' }} />
    </PointersDirective>
  </AxisDirective>
</AxesDirective>
  </CircularGaugeComponent>,
  document.getElementById('circulargauge')
);

import * as React from 'react';
import * as ReactDOM from 'react-dom';
import { CircularGaugeComponent, RangesDirective, RangeDirective, AxesDirective, AxisDirective, PointersDirective, PointerDirective, Inject, Gradient } from '@syncfusion/ej2-react-circulargauge';
ReactDOM.render(<CircularGaugeComponent>
<Inject services={[Gradient]}/>
<AxesDirective>
  <AxisDirective radius="80%" startAngle={200} endAngle={160} minimum={0} maximum={100} lineStyle={{ width: 0 }} labelStyle={{
    font: {
        fontWeight: 'Roboto',
        fontStyle: 'Regular',
        size: '0px',
        color: 'white'
    },
    position: 'Inside',
    useRangeColor: true
}} majorTicks={{ height: 0 }} minorTicks={{ height: 0 }}>
    <RangesDirective>
      <RangeDirective start={0} end={120} radius="90%" startWidth={30} endWidth={30} roundedCornerRadius={20} radialGradient={{
    radius: '50%',
    innerPosition: { x: '50%', y: '50%' },
    outerPosition: { x: '50%', y: '50%' },
    colorStop: [
        { color: '#9E40DC', offset: '90%', opacity: 0.9 },
        { color: '#E63B86', offset: '160%', opacity: 0.9 }
    ]
}}/>
    </RangesDirective>
    <PointersDirective>
      <PointerDirective pointerWidth={0} cap={{ radius: '0' }}/>
    </PointersDirective>
  </AxisDirective>
</AxesDirective>
  </CircularGaugeComponent>, document.getElementById('circulargauge'));

Ranges in React Circular Gauge component

Start and End

Customization

Radius

Dragging range

Multiple Ranges

Rounded corner radius

Gradient Color

Linear Gradient

Radial Gradient

See also