Skip to content
An extendable SVG donut chart React component
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
demo Updated babel deps (#19) Nov 8, 2018
lib Updated packages for bug fixes, updated linting Apr 25, 2018
mock Init Jul 12, 2016
tests
.babelrc Init Jul 12, 2016
.eslintrc Init Jul 12, 2016
.gitignore
.npmignore Init Jul 12, 2016
.travis.yml
CHANGELOG.md updated changelog May 15, 2018
CONTRIBUTING.md fixed build/dist process to avoid uglify issues (#1) Jul 12, 2016
LICENSE.md Init Jul 12, 2016
README.md
example.gif Init Jul 12, 2016
index.js
package-lock.json
package.json
webpack.config.js Updated packages for bug fixes, updated linting Apr 25, 2018

README.md

react-donut-chart


An extendable SVG-based donut chart React component.

Example


Installation

npm install react-donut-chart --save


Usage

import DonutChart from 'react-donut-chart';
//things I would never do:
<DonutChart
    data={[{
        label: 'Give you up',
        value: 25
    },
    {
        label: '',
        value: 75,
        isEmpty: true
    }]} />

View the demo online, or run it locally:

npm run build npm run start

then visit localhost:3000.


Props

Name Type isRequired Default Description
data arrayOf(shape({
  value: number.isRequired,
  label: string,
  className: string,
  isEmpty: boolean
}))
true [{
  value: 100,
  label: '',
  isEmpty:true
}]
The chart data
className string false donutchart This is the className given to the top-level svg element. All subclasses are prefixed from this name:
  • ${className}-arcs accesses the entire graph area
    • ${className}-arcs-paths accesses the individual arc paths
  • ${className}-innertext accesses all of the text within the inner donut area
    • ${className}-innertext-label accesses the label within this area
    • ${className}-innertext-value accesses the value within this area
  • ${className}-legend accesses the legend component
    • ${className}-legend-rect accesses the legend rectangle items
    • ${className}-legend-label accesses the labels of the legend items
In addition the selected class is given to selected items, the toggled class to all toggled items, and the isEmpty class to all isEmpty items. All style (and animations) can be manipulated from the CSS
height number false 500 Height of the entire component
width number false 750 Width of the entire component. If no legend is specified, then the chart takes up the entire width. If a legend is toggled, then the chart takes up 2/3 of the width, and the legend takes up 1/3
colors arrayOf(string) false ['#f44336', '#e91e63', '#9c27b0', '#673ab7', '#3f51b5', '#2196f3', '#03a9f4', '#00bcd4', '#009688', '#4caf50', '#8bc34a', '#cddc39', '#ffeb3b', '#ffc107', '#ff9800', '#ff5722', '#795548', '#607d8b' ] An array of colors (could be hex strings or named colors) for the data items. Defaults to an array of Google colors
emptyColor string false '#e0e0e0' A color for empty data items, defaults to gray
strokeColor string false '#212121' A color for the stroke around the items in the graph and legend, defaults to black
colorFunction func false (colors, index) => colors[(index % colors.length)] The default cycles through the array of colors and loops for excess
innerRadius number false 0.70 The inner donut radius
outerRadius number false 0.90 The outer donut radius
selectedOffset number false 0.03 The outerRadius offset when an item is selected
emptyOffset number false 0.08 The innerRadius and outerRadius offset on isEmpty items
toggledOffset number false 0.04 The innerRadius and outerRadius offset on toggle-clicked items
startAngle number false 0 The drawing start angle
formatValues func false (values, total) => `${(values / total * 100).toFixed(2)}%` Custom format for values displayed in the donut chart's inner text area. By default formats as percentages rounded to two decimal places.
onMouseEnter func false (item) => item Callback that fires when an item is hovered
onClick func false onClick: (item, toggled) => (toggled ? item : null) Callback that fires when an item is toggle-clicked
legend bool false true Determines whether or not to create a legend
clickToggle bool false true Determines whether or not to toggle-freeze the graph on the arc that has been clicked

License

MIT

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.