
Recharts 3.7.0 版本现已正式推出。Cell 组件已被标记为弃用,预计将在下一个主版本中被彻底移除。官方建议将所有使用 Cell 的场景迁移至对应图表组件的 shape 属性。
本次更新包含了以下内容:
新增功能(Feat)
新增 Hook
useIsTooltipActive:用于判断 Tooltip 当前是否处于活跃状态。useActiveTooltipCoordinate:用于获取当前 Tooltip 所在的坐标位置。
其他改进
Tooltip:支持offset属性接收 Coordinate 类型对象(如{ x: number, y: number })。XAxis/YAxis:新增轴类型"auto"。- 自动识别分类数据并设为
"category",数值型数据则设为"number"。
- 自动识别分类数据并设为
XAxis/YAxis:将tick: any替换为更明确、安全的类型定义。Bar/TypeScript:引入BarShapeProps类型,修复Bar.shape的类型推导问题。TypeScript:补充了shape、content等函数所需的实用类型导出。
问题修复(Fix)
BarChart:修复当单个数据序列包含三个及以上正值时,stackOffset="sign"模式下图表渲染异常的问题。BarStack:解决使用 Vite 构建项目时引发的循环依赖警告。BarStack:修正stackOffset="sign"场景下clipPath渲染错误的问。BarStack:为高亮(active)条形添加圆角支持,使其与堆叠半径保持一致。
构建与配置(Chore)
- 启用 TypeScript 的
strict模式编译选项。
文档优化(Docs)
目前大部分文档已实现自动化生成,显著提升了代码注释、正式文档及 Storybook 示例之间的一致性与准确性。
- 新增深色主题支持。
- 所有正式示例均已集成 Recharts 开发者工具,便于快速定位和调试问题。
更新详情请参见官方发布说明。
