跳到主要内容

从 1.x.x 迁移到 3.x.x(Migrating from 1.x.x to 3.x.x)

总体上,从 v1.x.x 升级到 v3.x.x 改动较少。

说明(Note):v2.x.x -> v3.x.x 通常可无改动迁移。

依赖变化

早期你可能安装:

npm i rive-react

后续推荐按渲染器拆分:

  • @rive-app/react-canvas(推荐默认)
  • @rive-app/react-webgl(需要 WebGL 时)
npm i @rive-app/react-canvas

rive-react 仍会发布,但因同时依赖两套 runtime,包体可能更大。

Props 透传行为变化

RiveComponent 结构是「外层 div + 内层 canvas」。

从 v2 开始:

  • className / style → 透传到外层 <div>
  • 其他属性(如 aria-*)→ 透传到 <canvas>

这让无障碍属性更容易直接落在 canvas 元素上。