+1
日增长
8,784
stars
830
forks
2,107
watchers
663
prs
824
issues
59
releases
README
react-vis | Demos | Docs
A COMPOSABLE VISUALIZATION SYSTEM
!demo
_NOTE:_ This repository is now under new management. Please reach out to the new administrators if you have any questions.
Overview
A collection of react components to render common data visualization charts, such as line/area/bar charts, heat maps, scatterplots, contour plots, hexagon heatmaps, pie and donut charts, sunbursts, radar charts, parallel coordinates, and tree maps.
Some notable features:
- Simplicity. react-vis doesn't require any deep knowledge of data visualization libraries to start building your first visualizations.
- Flexibility. react-vis provides a set of basic building blocks for different charts. For instance, separate X and Y axis components. This provides a high level of control of chart layout for applications that need it.
- Ease of use. The library provides a set of defaults which can be overridden by the custom user's settings.
- Integration with React. react-vis supports the React's lifecycle and doesn't create unnecessary nodes.
Usage
Install react-vis via npm.
npm install react-vis --save
Include the built main CSS file in your HTML page or via SASS:
scss
@import "~react-vis/dist/style";
You can also select only the styles you want to use. This helps minimize the size of the outputted CSS. Here's an example of importing only the legends styles:
scss
@import "~react-vis/dist/styles/legends";
Import the necessary components from the library...
jsx
import {XYPlot, XAxis, YAxis, HorizontalGridLines, LineSeries} from 'react-vis';
… and add the following code to your render function:
jsx
If you're working in a non-node environment, you can also directly include the bundle and compiled style using basic html tags.
html
The global reactVis object will now be available for you to play around.
You can checkout these example CodePens:
1,
2,
3 or
4
More information
Take a look at the folder with examples or check out some docs:
- Common concepts:
Scales and Data about how the attributes can be adjusted.
Animations about how to tweak animations in the library.
- Components:
XYPlot about orthogonal charts.
RadialChart about radial charts.
Treemap about making tree maps.
Sankey about making sankey diagrams.
Radar Chart about making radar charts.
Parallel Coordinates about making parallel coordinate charts.
Sunbursts about making sunburst diagrams.
Legends about the legends.
Development
Make sure you are using the correct version of node and yarn. To do so, check package.json and find the entry "volta", e.g.
"volta": {
"node": "14.18.0",
"yarn": "1.22.4"
}
It's recommanded to install volta to manage node and yarn.
To develop on react-vis, navigate to packages/react-vis, and install the dependencies and then build and watch the static files:
yarn && yarn start
Once complete, you can view the component's example in your browser (will open automatically).
Any changTop issues
#1303This repository is currently inactive but we're looking for maintainers27 comments · 2020-01-10#1320Refactor Components to use Hooks14 comments · 2020-05-22#518Bar Series onValueMouseOut not triggering13 comments · 2017-07-25#671xAxis labels render on each other12 comments · 2017-11-30#1356Support React 1711 comments · 2020-06-15#845Real time interactive graph11 comments · 2018-06-27#1435npm ERR! peer react@"15.3.0 - 16.x" from [email protected] with NPM 7 or above install10 comments · 2021-10-28#823RFC Drop scss in favor of styled-components10 comments · 2018-05-29
Latest release
1.11.7 v1.11.7 2019-04-19- Missing colon on series.md (1087) - Docs: simplify usage (1094) - Alphabetize imports (1105) - Add className functionality to Hint and GridLines (1008) - Fix a misnamed prop in colors doc (1127) - Fix a typo (1133) - Fix/inconsistent proptypes of discrete color legend (1147) - Fix webpack windows build issue(940) (1144) - Update LabelSeries doc with a link that has more info on svg-text (1150) - Fix stacking together different series types (1037) (1145)