Skip to content

twisty/react-radial-progress-indicator

Repository files navigation

Bundle size GitHub issues CodeFactor GitHub license

react-radial-progress-indicator

A React component that displays a customisable circular progress indicator.

The indicator can display segmented steps (like “you’re on step 3/10”), or a smooth sweep to any position around the ring (useful when progress is measured as a percentage).

Features

  • Lightweight: ~2kb when minified and gzipped. No runtime dependencies.
  • Responsive: draws natively at the pixel density of your screen using HTML5 canvas.
  • Tweakable: colours, layout metrics, and text can be fine-tuned for your layout.
  • Animatable: animates between steps with customisable speed.

Install

Install with yarn…

yarn add react-radial-progress-indicator

…or npm:

npm install react-radial-progress-indicator

Examples

Animated example

For examples and usage, have a look at this storybook.

Usage

import React from 'react'
import { RadialProgress } from 'react-radial-progress-indicator';

const UsageExample = (props) => {
  return (
    <RadialProgress
      width={100}
      height={100}
      steps={10}
      step={3}
    />
  );
);

See the jsx tab in the storybook for more usage examples.

API

A full list of props available to customise the component can be found here: docs/api.md