# React minimal pie chart [![Build Status][ci-badge]][ci] [![Npm version][npm-version-badge]][npm] [![Coveralls][coveralls-badge]][coveralls] [![Bundle size][bundlephobia-badge]][bundlephobia] Lightweight React **SVG pie charts**, with **versatile options** and **CSS animation** included. πŸ‘  [Demo][storybook] πŸ‘. ```js import PieChart from 'react-minimal-pie-chart'; ; ``` ## Installation ```console npm install react-minimal-pie-chart ``` If you don't use a package manager, `react-minimal-pie-chart` exposes also an `UMD` module ready for the browser. ``` https://unpkg.com/react-minimal-pie-chart/dist/index.js ``` ## Why? Because [Recharts](https://github.com/recharts/recharts) is awesome, but when you just need a simple pie/donought chart, **3 kB** of code are usually enough. ## Features - No dependencies (except for [React's prop-types](https://github.com/reactjs/prop-types)) - Customizable CSS animations with [stroke-dasharray + stroke-dashoffset strategy](https://css-tricks.com/svg-line-animation-works/) - Configurable: Pie, Donut, Loading, Completion charts, Labels (see [Demo][storybook]) ## Options | Property | Type | Description | Default | | --------------------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | | **data** _(required)_ | _Array_ | The source data which each element is a segment. | - | | **cx** | _Number_ | The x-coordinate of center. The value is the percentage of the component width | 50 | | **cy** | _Number_ | The y-coordinate of center. The value is the percentage of the component height | 50 | | **ratio** | _Number_ | The ratio of rendered svg element | 1 | | **startAngle** | _Number_ | The start angle of first sector | 0 | | **lengthAngle** | _Number_ | The total angle taken by the chart _(can be negative to make the chart clockwise!)_ | 360 | | **totalValue** | _Number_ | The total value represented by the full chart | - | | **radius** | _Number_ | The radius of the pie. The value is the percentage of the component's width | 50 | | **lineWidth** | _Number_ | The width of the line representing each sector. The value is the percentage of chart's radio _(100 === full pie)_ | 100 | | **paddingAngle** | _Number_ | The angle between two sectors | - | | **rounded** | _Bool_ | Round line caps of each sector | false | | **segmentsStyle** | _Object_ | Style object assigned each segment | - | | **animate** | _Bool_ | Animate sectors on component mount | false | | **animationDuration** | _Number_ | Animation duration in ms | 500 | | **animationEasing** | _String_ | Animation CSS easing | "ease-out" | | **reveal** | _Number_ | Turn on CSS animation and reveal just a percentage of each segment | - | | **injectSvg** | _Function_ | Inject `` element with the output of the provided function (eg. gradients) | - | | **label** | _Boolean_, _ReactElement_, _Function_ | If true set, labels will be drawn automatically. If ReactElement set, the option can be the custom label element. If set a function, the function will be called to render customized label. | false | | **labelPosition** | _Number_ | Label position from origin. The value is the percentage of chart's radio _(50 === middle point)_ | 50 | | **labelStyle** | _Object_ | Style object assigned by default to each label | - | | **onClick** | _Function_ | Custom event handler of `onClick` on each sector : `(event, data, dataIndex) => {}` | - | | **onMouseOver** | _Function_ | Custom event handler of `onMouseOver` on each sector : `(event, data, dataIndex) => {}` | - | | **onMouseOut** | _Function_ | Custom event handler of `onMouseOut` on each sector : `(event, data, dataIndex) => {}` | - | ### `label` prop When `label` is a **function** or **ReactElement**, the provided entity will be called with the following object respectively **as first argument** or **as props**: ```typescript const labelProps = { key: string, x: number, y: number, dx: number, dy: number, textAnchor: string, data: { // props.data array extended with: degrees: number, startOffset: number, percentage: number, }[], dataIndex: number, color: string, style: {[key: string]: string | number}, }; ``` See some examples in the [demo source][demo-label-source]. ### Optional `data.key` value Each **data** entry can also accept an **optional [`key` property](https://reactjs.org/docs/lists-and-keys.html)** just in case items' indexes weren't enough: ```js { value: 10, key: 1, color: '#E38627' } ``` ## How to ### User interactions with the chart See [demo][demo-interaction] and its [source][demo-interaction-source]. ## Browsers support The main requirement of this library is an accurate rendering of [SVG Stroke properties](https://www.w3schools.com/graphics/svg_stroking.asp). ### Not supported - IE ≀ 10 ### Partially supported - IE 11 ## Misc ### How svg arc paths work? https://codepen.io/lingtalfi/pen/yaLWJG ### Size comparison 3kB ## Todo's - Find a better `paddingAngle` implementation - Make a device/browser compatibility table - Background segment - Consider switching `ReactMinimalPieChart` to extend default `React.Component` - Consider moving storybook deployment to CI - Update to babel 7 along with Storybook - Get rid of duplicated looping logic in `makeSegments` and `makeLabels` - Configure Babel's "transform-object-rest-spread" with `"useBuiltIns": true` - Consider migrating source to TypeScript ## Contributors Thanks to you all ([emoji key](https://github.com/kentcdodds/all-contributors#emoji-key)): | [
Andrea Carraro](http://www.andreacarraro.it)
[πŸ’»](https://github.com/toomuchdesign/react-minimal-pie-chart/commits?author=toomuchdesign "Code") [πŸ“–](https://github.com/toomuchdesign/react-minimal-pie-chart/commits?author=toomuchdesign "Documentation") [πŸš‡](#infra-toomuchdesign "Infrastructure (Hosting, Build-Tools, etc)") [⚠️](https://github.com/toomuchdesign/react-minimal-pie-chart/commits?author=toomuchdesign "Tests") [πŸ‘€](#review-toomuchdesign "Reviewed Pull Requests") | [
Stephane Rufer](https://github.com/rufman)
[πŸ›](https://github.com/toomuchdesign/react-minimal-pie-chart/issues?q=author%3Arufman "Bug reports") [πŸ’»](https://github.com/toomuchdesign/react-minimal-pie-chart/commits?author=rufman "Code") | [
JΓΈrgen Aaberg](https://github.com/jaaberg)
[πŸ’»](https://github.com/toomuchdesign/react-minimal-pie-chart/commits?author=jaaberg "Code") | [
Tobiah Rex](http://www.tobiahrex.com)
[πŸ›](https://github.com/toomuchdesign/react-minimal-pie-chart/issues?q=author%3ATobiahRex "Bug reports") | [
Edward Xiao](https://edwardxiao.com)
[πŸ›](https://github.com/toomuchdesign/react-minimal-pie-chart/issues?q=author%3Aedwardfhsiao "Bug reports") | [
David Konsumer](https://keybase.io/konsumer)
[πŸ’»](https://github.com/toomuchdesign/react-minimal-pie-chart/commits?author=konsumer "Code") [πŸ“–](https://github.com/toomuchdesign/react-minimal-pie-chart/commits?author=konsumer "Documentation") [πŸ’‘](#example-konsumer "Examples") [πŸ€”](#ideas-konsumer "Ideas, Planning, & Feedback") | [
Ori](https://github.com/nehoraigold)
[πŸ€”](#ideas-nehoraigold "Ideas, Planning, & Feedback") | | :---: | :---: | :---: | :---: | :---: | :---: | :---: | [ci-badge]: https://travis-ci.org/toomuchdesign/react-minimal-pie-chart.svg?branch=master [ci]: https://travis-ci.org/toomuchdesign/react-minimal-pie-chart [coveralls-badge]: https://coveralls.io/repos/github/toomuchdesign/react-minimal-pie-chart/badge.svg?branch=master [coveralls]: https://coveralls.io/github/toomuchdesign/react-minimal-pie-chart?branch=master [npm]: https://www.npmjs.com/package/react-minimal-pie-chart [npm-version-badge]: https://img.shields.io/npm/v/react-minimal-pie-chart.svg [bundlephobia-badge]: https://badgen.net/bundlephobia/minzip/react-minimal-pie-chart [bundlephobia]: https://bundlephobia.com/result?p=react-minimal-pie-chart [storybook]: https://toomuchdesign.github.io/react-minimal-pie-chart/index.html [demo-interaction]: https://toomuchdesign.github.io/react-minimal-pie-chart/index.html?selectedKind=React%20minimal%20pie%20chart&selectedStory=Interaction%20using%20click%2FmouseOver%2FmouseOut&full=0&addons=1&stories=1&panelRight=0&addonPanel=storybook%2Factions%2Factions-panel [demo-interaction-source]: https://github.com/toomuchdesign/react-minimal-pie-chart/blob/v3.5.0/stories/InteractionStory.js [demo-label-source]: https://github.com/toomuchdesign/react-minimal-pie-chart/blob/v3.5.0/stories/index.js#L94