Download Latest Version v3.1.0 source code.tar.gz (1.2 MB)
Email in envelope

Get an email when there's a new version of Recharts

Home / v3.0.0
Name Modified Size InfoDownloads / Week
Parent folder
README.md 2025-06-23 3.1 kB
0
v3.0.0 source code.tar.gz 2025-06-23 861.6 kB
0
v3.0.0 source code.zip 2025-06-23 1.2 MB
0
Totals: 3 Items   2.0 MB 0

🚀 Recharts 3 is here!

Huge shoutout to @PavelVanecek who wrote 95% of the code for this major version release. We re-wrote recharts state management, wrote some 3500 unit tests, fixed a bunch of bugs, and added a few well-requested features.

The intent with 3.0 is that it is now a better/easier place for the community to contribute to. Looking forward to what the future of recharts looks like in 3.x and beyond!

More details and the 3.0 migration guide

BREAKING CHANGES

Please see https://github.com/recharts/recharts/wiki/3.0-migration-guide#breaking-code-changes

tldr; * CategoricalChartState (which was access to recharts internal state) no longer exists in event handlers or Customized, etc. * Customized no longer receives recharts state/props * Removal of internal props that were always supposed to only be internal to recharts * Remove previously deprecated props * ...see full list linked above

New Features

  • Custom Components - you can now render any react component in the recharts tree structure (but it must still be renderable within an SVG). Previously this was controlled and filtered by recharts
  • Tooltip Portals - you can now use portals to position your tooltip data anywhere you'd like, including outside of your chart
  • Legend Portals - similar to the above, you can now use portals to position your Legend anywhere you'd like, including outside of your chart
  • Accessible by default - accessibilityLayer is now on on all polar and cartesian charts by default. Tab into the chart and use the arrow keys to navigate.
  • Polar charts now support multiple axes (similar to cartesian charts)
  • Tooltip: You can now select which axis your Tooltip belongs to using axisId
  • YAxis: auto width calculation for YAxes - set width="auto"
  • X/YAxis: Add symlog d3 scale type

Bug fixes and improvements

This release fixes some long standing issues in recharts, the easiest way to determine all of them is to take a look at the recharts 3.0 project board

  • Animation improvements
  • Typescript improvements
  • Accessibility fixes/improvements
  • Pie: no more border around pie sectors on click, etc.
  • CartesianGrid: background now renders below the grid lines instead of above
  • and more!

Our 3.0 storybook has a lot of updated examples!

Source: README.md, updated 2025-06-23