Gauges / Overview
material theme

KendoReact Gauges Overview

The KendoReact Gauges provide a set of React components for building common gauge types.

The KendoReact Gauges components are distributed through NPM under the kendo-react-gauges NPM package.

The Gauges package is part of KendoReact, a professionally built commercial UI library. To try out this package you need to sign up for a 30-day trial, which gives you access to the full KendoReact library.

Start Free Trial
ArcGauge

A component for representing values on an arc scale.
LinearGauge

A component for representing values on a linear scale.
RadialGauge

A component for representing values on a radial scale.

Basic Usage

The following example demonstrates the Arc, Linear, and Radial Gauges in action.

import * as React from 'react';
import * as ReactDOM from 'react-dom';
import {
    ArcGauge,
    LinearGauge,
    RadialGauge
} from '@progress/kendo-react-gauges';

const DemoContainer = ({ heading, children }) =>
    (<div><h1>{heading}</h1>{children}</div>);

const value = 30;
const pointer = {
    value: value
};

const arcCenterRenderer = (currentValue, color) => {
    return (<h3 style={{ color: color }}>{currentValue}%</h3>);
};

const gaugeStyles = {
    display: 'block'
};

const GaugeContainer = () => (
    <DemoContainer heading="Gauges demos">
        <div className="row">
            <div className="col-sm-12 col-md-2">
                <LinearGauge style={gaugeStyles} pointer={pointer} />
            </div>
            <div className="col-sm-12 col-md-5">
                <RadialGauge style={gaugeStyles} pointer={pointer} />
            </div>
            <div className="col-sm-12 col-md-5">
                <ArcGauge style={gaugeStyles} value={value} arcCenterRender={arcCenterRenderer} />
            </div>
        </div>
    </DemoContainer>
);

ReactDOM.render(
    <GaugeContainer />,
    document.querySelector('my-app')
);

Installation

  1. Download and install the package. Use Node.js v5.0.0 or later.

    npm install --save @progress/kendo-react-gauges @progress/kendo-drawing @progress/kendo-react-intl

  2. Once installed, import the package module.

    // ES2015 module syntax
import { ArcGauge, LinearGauge, RadialGauge } from '@progress/kendo-react-gauges';
    // CommonJS format
const { ArcGauge, LinearGauge, RadialGauge } = require('@progress/kendo-react-gauges');

  3. You are required to install one of the Kendo UI themes to style your components. For more information on how to add the styles, refer to the article on getting started.

Dependencies

The Gauges package requires you to install the following peer dependencies in your application:

  • react 16.8.2*
  • react-dom
  • @progress/kendo-react-intl
  • @progress/kendo-drawing

The following dependencies are automatically installed:

  • @progress/kendo-react-common
  • @progress/kendo-charts
  • prop-types

Is this article helpful?

Not finding the help you need?

Contact Support