近日,我注意到 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 开发者工具,便于排查问题。
