Recharts 3.7.0 发布:React 和 D3 构建的图表库

作者:技术拾光时间:2026-08-03 08:08:09浏览:546

Recharts3.7.0正式发布上线,Cell组件已弃用,需要迁移至图表组件的shape属性。新增useIsTooltipActive与useActiveTooltipCoordinate两个Hook函数。Tooltip偏移量支持坐标对象类型,X轴与Y轴新增自动轴类型。Bar组件修复TypeScript类型定义问题,并且修复了BarChart在嵌套图表中的

近日,Recharts 3.7.0 版本正式发布。本次更新最值得关注的信号是:Cell 组件已被正式标记为弃用,将在下一个主版本中彻底移除。官方明确要求,所有原本使用 Cell 的地方,均需迁移至对应图表组件的 shape 属性。

新增功能(Feat)

新增 Hook

  • useIsTooltipActive:用于判断 Tooltip 当前是否处于激活状态(#6880)
  • useActiveTooltipCoordinate:可获取当前 Tooltip 所在的坐标位置(#6880)

其他改进

  • Tooltip 的 offset 属性现已支持接收 { x, y } 坐标对象(#6868)
  • XAxis 与 YAxis 新增 "auto" 轴类型(#6823),可自动识别数据:分类数据走 "category",数值型走 "number"
  • XAxis 与 YAxis 原有的 tick: any 类型被替换为更明确、更安全的类型定义(#6911)
  • Bar 组件引入 BarShapeProps 类型,修复了 Bar.shape 在 TypeScript 中的类型推导问题(#6900)
  • TypeScript 方面补充了一批实用类型导出,例如 shape、content 等函数所需的类型(#6852)

问题修复(Fix)

  • BarChart 修复了一个隐蔽问题:当单个数据序列包含三个及以上正值时,stackOffset="sign" 模式下图表渲染出现异常(#6807)
  • BarStack 解决了使用 Vite 构建项目时触发的循环依赖警告(#6777)
  • BarStack 在 stackOffset="sign" 场景下的 clipPath 渲染错误已得到修正(#6806)
  • BarStack 为高亮(active)的条形添加了圆角支持,确保堆叠半径一致(#6906)

构建与配置(Chore)

  • TypeScript 编译选项启用了 strict 模式(#6842),类型检查更为严格,有助于排查潜在隐患。

文档优化(Docs)

本次版本重点优化了文档建设。大部分文档已实现自动化生成,代码注释、官网文档以及 Storybook 示例之间的一致性得到显著提升。

  • 新增深色主题支持(#6828)
  • 所有官网示例集成了 Recharts 开发者工具,方便问题排查。