3.2.0 • Published 6 years ago
react-svg-doughnut v3.2.0
React SVG doughnut
A flexible, lightweight React component for SVG doughnut graphics made easy!
Installation
React SVG doughnut can be downloaded with yarn:
yarn add react-svg-doughnut
Or via NPM:
npm install react-svg-doughnut --save
Example of basic Usage:
import React from 'react';
import ReactDOM from 'react-dom';
import SvgDoughnut from 'react-svg-doughnut';
class Example extends React.Component {
render() {
const settings = {
value: 100,
labelText: 'Awesome!',
size: 180,
thickness: 5,
animationDuration: 1000
};
return(
<div>
<SvgDoughnut {...settings}/>
</div>
);
}
};
ReactDOM.render(
<Example />,
document.getElementById('app')
);
Configuration
React SVG doughnut uses the following props to build the graphic.
Prop | Type | Default Value | Description |
---|---|---|---|
value | Number | 0 | Value to be displayed in the centre of a graphic |
size (px) | Number | 150 | Width and height of the graphic in pixels |
thickness (px) | Number | 5 | Thickness of the graphic ring in pixels |
animationDuration (ms) | Number | - | Optional duration of the generation animation in milliseconds. No animation is triggered when set to undefined. |
primaryColour | String | '#e7534f' | Colour of the percentage and completion path of the graphic (valid css colour string). |
ringColour | String | '#DDD' | Colour of the ring path of the graphic (valid css colour string). |
labelText | String | - | Optional label text displayed under the percentage value. |
labelColour | String | '#333' | Colour of the optional label text (valid css colour string). |
labelPosition | String | 'bottom' | Position of the optional label. 'top' or 'bottom' |
labelFontSize (px) | Number | 14 | Label font size in pixels. |
labelFontWeight | String | 'normal' | Label font weight (valid css fontWeight string). |
percentageFontSize (px) | Number | 28 | Percentage font size in pixels. |
percentageFontWeight | String | 'bold' | Percentage font weight (valid css fontWeight string). |
ceiling | Number | 100 | The ceiling used to calculate the percentage / fraction |
format | String | 'percentage' | The format displayed. 'percentage' or 'fraction' |
License: MIT