168 lines
14 KiB
Markdown
168 lines
14 KiB
Markdown
# 拼豆图纸生成器 · 竞品动画与交互研究
|
||
|
||
> 调研日期: 2026-08-14
|
||
> 目的: 为原型 `docs/prototype-home.html` 的动效升级提供落地依据
|
||
> 方法: 竞品缓存 HTML/JS 逆向分析 + 4 次网络检索(leafer.js / anime.js vs lottie / 独立站案例)
|
||
|
||
---
|
||
|
||
## 1. 竞品 pixel-beads.com 动画/交互特征(证据来自缓存文件)
|
||
|
||
**数据来源**: `raw/js/PixelBeadGenerator-C4oOWXAT.js`、`raw/js/index-j6j51b9x.js`、`raw/showcase-card-region.txt`
|
||
|
||
### 1.1 技术栈判断
|
||
- 前端框架: Next.js (React) + Tailwind CSS
|
||
- 动效体系: **以 CSS transition/keyframes 为主 + 少量 JS 驱动**(未使用 GSAP/anime/lottie 这类重量级库)
|
||
- 组件库: sonner(toast 通知)、lucide(图标)
|
||
|
||
### 1.2 动效证据统计(实测)
|
||
| 证据 | 数量 | 说明 |
|
||
|---|---|---|
|
||
| `transition:` | 56 处 | 交互反馈几乎全部走 CSS transition |
|
||
| `@keyframes` | 7 处 | swipe-out×4、sonner-fade-in/out、sonner-spin |
|
||
| `requestAnimationFrame` | 3 处 | 仅用于聚焦 + scrollIntoView(非动画主驱动力) |
|
||
| `getContext("2d")` | 2 处 | 图纸渲染用原生 Canvas |
|
||
| `will-change-transform` | 1 处 | 图纸拖拽的 GPU 加速提示 |
|
||
|
||
### 1.3 具体动画模式(可直接照搬的设计语言)
|
||
1. **图纸画布渲染 = 原生 Canvas 逐格填充**
|
||
- 每个豆子一格:`imageSmoothingEnabled=false` + `fillRect` 逐格绘制(保证像素边缘锐利)
|
||
- 颜色映射做了缓存:`F.get(v) || (N=po(v), F.set(v,N))`(同色不重复创建画刷)
|
||
- 画布底色固定 `#f8fafc`
|
||
2. **图片转图纸 = Web Worker 后台处理 + 加载态**
|
||
- `new Worker("/assets/processing.worker-*.js")` 主线程不阻塞,`worker.terminate()` 及时回收
|
||
- 处理期间按钮显示 `animate-spin` 图标 + "processing"(加载中)/ "getStarted"(开始)双文案
|
||
3. **图纸拖拽 = Pointer 事件 + GPU 合成层**
|
||
- `onPointerDown` + `setPointerCapture(pointerId)`(拖拽不丢失)
|
||
- 位置用 `translate3d(x,y,0)` + `will-change-transform`(合成器线程动画,不触发 reflow)
|
||
4. **Toast 通知 = sonner 轻量反馈**
|
||
- fade-in(scale .8→1)/ fade-out,加载条 `sonner-spin 1.2s linear infinite`
|
||
- 四方向 swipe-out 手势关闭动画
|
||
5. **作品卡片 hover = 分层过渡**
|
||
- 图片 `transition-transform duration-500 group-hover:scale-110`(缩放 1.0→1.1,500ms)
|
||
- 操作层遮罩 `transition-opacity duration-200 md:opacity-0 md:group-hover:opacity-100`(桌面端 hover 淡入)
|
||
- 按钮 `transition-colors hover:bg-white`(背景色过渡)
|
||
6. **导出 = `toDataURL("image/webp")`**(WebP 格式,比 PNG 体积小约 50%+)
|
||
|
||
### 1.4 结论
|
||
竞品没有炫技式动效,其"高级感"来自:**克制的速度节奏**(200/500ms 过渡)、**GPU 合成层动画**(transform/opacity,不碰 layout)、**过程可视化**(worker 加载态 + toast 确认)。这是我们的基准线。
|
||
|
||
---
|
||
|
||
## 2. 三个库对比表
|
||
|
||
| 维度 | **leafer.js** | **anime.js** | **lottie-web** |
|
||
|---|---|---|---|
|
||
| 类型 | 2D Canvas 图形渲染引擎 | JS 动画库(属性补间) | AE 矢量动画播放器 |
|
||
| 本质 | 画布上的"场景图",可交互图形对象 | 驱动任意 JS 对象/DOM/CSS 属性的时间线 | 解析 Bodymovin 导出的 JSON 并播放 |
|
||
| 体积 | CDN 单文件 ~几百 KB(按需模块化) | 16.1 KB gzipped(v4 模块化后更小) | ~50-75 KB gzipped(runtime) |
|
||
| 核心优势 | 百万级图形对象渲染、批处理 DrawCall、脏矩形局部刷新 | 极轻量、API 简单、spring 物理、stagger 序列 | 设计稿→代码保真度 100%、跨端一致(web/iOS/Android) |
|
||
| 性能 | 100 万个交互矩形首屏 1.5s;比同类引擎快 ~10 倍、省内存 ~10 倍 | 基于 rAF,但动画的是 JS/DOM 属性,受 DOM 数限制 | JSON 解析 + 每帧插值在主线程,复杂动画吃 CPU、创建大量 SVG DOM |
|
||
| 学习成本 | 平缓(现代 API,类 Fabric/Konva 但更简) | 很低(几行上手) | 低(前端无创作成本,但需设计师用 AE 制作) |
|
||
| 适用场景 | 图纸画布、图像处理工具、可视化编辑器 | DOM/CSS 微交互、入场动画、拖拽、stagger 列表 | 品牌动画、Hero 插画、加载引导、成功/空状态插画 |
|
||
| 生态 | 较新,第三方插件少;官方 canvas-benchmark 对比 Pixi/Konva/Fabric | 社区成熟(128 weekly downloads 偏低,作者维护缓慢) | 行业标准(7.1M weekly downloads),LottieFiles 大量现成素材 |
|
||
| **拼豆场景适配度** | ★★★★★ 图纸网格本质是数千~数万矩形,正是其批处理强项;支持交互对象(点击/拖拽豆子) | ★★★★ 用于按钮/加载/颜色闪烁等 UI 微交互很合适;不负责画布渲染 | ★★☆ 只适合品牌/引导类装饰动画;图纸本身不应走 Lottie |
|
||
|
||
> 数据来源: leaferjs.com/ui/guide/performance.html;github.com/leaferjs/canvas-benchmark;pkgpulse.com/compare/anime-vs-lottie-web(anime 16.1KB gz / lottie 75KB gz / 下载量对比);cloversreport.com(lottie runtime 约 60KB,微交互 SVG+CSS 约 400B,小动效 5-10 倍体积差)
|
||
|
||
### 2.1 关键结论(对比中反复出现的共识)
|
||
- **微交互(hover/加载/按钮/闪烁)→ 优先 CSS 或 anime.js**,保持 transform/opacity 以留在合成器线程;Lottie 做这些是"杀鸡用牛刀"(60KB runtime 起)
|
||
- **设计稿级品牌动画/引导序列 → Lottie**,前提是团队有 AE 设计师
|
||
- **画布类渲染(图纸网格)→ 不在这三个库的标准讨论里,leafer.js 是唯一直接对标场景图渲染的方案**
|
||
|
||
---
|
||
|
||
## 3. 推荐方案(分库分层)
|
||
|
||
### 3.1 分层架构建议
|
||
```
|
||
┌─────────────────────────────────────────────┐
|
||
│ 第 4 层: 品牌/装饰动画 → lottie (可选) │ 仅 Hero 引导或生成完成庆祝动画
|
||
├─────────────────────────────────────────────┤
|
||
│ 第 3 层: JS 微交互 → anime.js │ 颜色闪烁、下载按钮、stagger 列表
|
||
├─────────────────────────────────────────────┤
|
||
│ 第 2 层: 基础 UI 过渡 → CSS/Tailwind │ hover、toast、遮罩淡入(对齐竞品基准)
|
||
├─────────────────────────────────────────────┤
|
||
│ 第 1 层: 图纸画布渲染 → leafer.js │ 豆子网格 + 拖拽 + 实时更新(核心)
|
||
└─────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 3.2 各层具体建议
|
||
1. **leafer.js → 图纸画布渲染(核心)**
|
||
- 每个豆子 = 一个 `Rect` 对象,group 化分批;超大图纸(>1万豆)自动受益于批处理 DrawCall 与脏矩形局部刷新
|
||
- 参考迁移数据:像素编辑器从 Konva 迁 Leafer 后,1000 元素 4K 下帧率 25-30→58-60 FPS、内存 120MB→40MB、DrawCall 800+→<50、点选 80ms→10ms
|
||
- 佐证:百度公开的像素风编辑器迁移文章 + 开源 Canva 平替 Gzm Design 均选 LeaferJS;官方 benchmark 覆盖平移/缩放/拖拽/全动态元素场景,正对应图纸预览需求
|
||
2. **anime.js → 交互微动画**
|
||
- v4 模块化按需引入(`animate`/`createTimeline`/`createDraggable`/`stagger`),16KB 内,弹簧物理适合"豆子落下"这类弹性效果
|
||
- 相比竞品只用 CSS transition,anime.js 能提供**序列化**(先放大再变色再缩小)和 **stagger**(逐颗豆子错开动画),这是拉开体验差距的抓手
|
||
3. **lottie-web → 仅品牌/引导级动画(可选,低优先级)**
|
||
- 若团队有 AE 设计师:生成完成庆祝、Logo 动画、首次使用引导插画用 Lottie;若无设计师,**跳过这一层**,用 anime.js + SVG 手工实现,避免 60KB runtime 成本
|
||
- 若采用,务必用 `.lottie`/dotLottie 格式(压缩 70-80%)并懒加载 runtime
|
||
4. **CSS/Tailwind → 基础层,直接对标竞品**
|
||
- 竞品的 56 处 transition 已证明:不引库也能做出基准级"高级感",先补这层再考虑引入库
|
||
|
||
---
|
||
|
||
## 4. 可落地的交互动画清单(原型增强用)
|
||
|
||
> 编号 A1-A5,均给出具体效果参数,前端可直接实现。优先级 ★ = 性价比。
|
||
|
||
### A1. 图纸生成进度动画 ★★★★★
|
||
- **触发**: 点击"生成图纸"后,图片→像素网格转换进行中
|
||
- **效果**: ① 生成按钮变加载态:图标 `animate-spin` + 文案从"生成图纸"→"处理中…"(竞品同款双文案);② 图纸画布从模糊灰块渐入到清晰网格(`filter: blur(6px)→0` + `opacity 0→1`,600ms ease-out);③ 画布下方细进度条 0→100%(`width` transition 或 anime.js `tween`)
|
||
- **实现**: 图片转像素放 Web Worker(竞品同款做法),主线程只负责动画,保证 60FPS
|
||
- **对齐**: 竞品 loading 态 + 百度迁移文章强调"WebWorker 离屏渲染避免阻塞 UI"
|
||
|
||
### A2. 豆子放置动画 ★★★★★(拉开差距的核心项)
|
||
- **触发**: 用户点击画布放置/填充一颗豆子
|
||
- **效果**: 豆子从中心小圆点快速弹入格位——`scale 0→1` 带 spring 回弹(anime.js `spring(stiffness:170, damping:26)`),耗时 120-180ms;**连续放置时用 stagger(30ms) 让豆子逐颗错开出现**(瀑布式填充,视觉冲击极强)
|
||
- **实现**: leafer.js 中豆子为交互对象,放置时对 `scale` 属性做 rAF 补间;颜色变化用瞬时切换 + 短暂发光(`filter: brightness(1.4)` 120ms)
|
||
- **对齐**: 竞品无此动效(只做了静态网格),是我们的差异化优势;Novaboard 像素编辑器证明浏览器端逐格动画可行
|
||
|
||
### A3. 颜色匹配闪烁 ★★★★
|
||
- **触发**: 图纸某豆子颜色与当前选中色一致 / 吸管取色时高亮
|
||
- **效果**: 匹配的豆子**呼吸式闪烁** 2 次(`opacity 1→0.4→1`,各 150ms),或描边光环扩散一圈(`stroke-width`/`box-shadow` 外扩,300ms)后消失
|
||
- **实现**: CSS keyframes 对单格 DOM/或 leafer 对象属性补间;多颗同时匹配用 stagger 错峰
|
||
- **对齐**: 竞品代码中已有 swipe-out/sonner 式 keyframes 先例,属同量级动效;提升"颜色对应"的即时反馈
|
||
|
||
### A4. 下载按钮反馈 ★★★★
|
||
- **触发**: 点击"下载图纸"
|
||
- **效果**: ① 按钮内图标切换为 ✓(`transition-colors` 变绿,200ms);② 短促的 scale 按压反馈(`active:scale-95`,100ms);③ 若导出耗时 >500ms,按钮变下载进度环(SVG `stroke-dashoffset` 动画);④ toast 弹出"图纸已保存 ✓"(sonner fade-in,scale .8→1)
|
||
- **实现**: CSS 即可完成 ①②③;toast 对齐竞品 sonner 样式
|
||
- **对齐**: 竞品导出 WebP + sonner 通知;Toss/Touch 用 Lottie 做成功 ✓ 动画可作参考(低成本版本用 anime.js 画勾)
|
||
|
||
### A5. 页面过渡 / 首屏入场 ★★★☆
|
||
- **触发**: 原型页面加载 / 切换「上传图片 ↔ 图纸编辑」两态
|
||
- **效果**: ① 首屏元素 stagger 入场(标题/按钮/示例卡片依次 `opacity+translateY(12px)` 淡入,间隔 60ms,总时长 <900ms);② 上传后图片预览区做**翻页/擦除过渡**进入图纸区(View Transitions API 或 `clip-path` 圆形扩散 400ms)
|
||
- **实现**: anime.js `stagger` 做首屏序列;页面切换优先用 CSS `transition`/View Transitions,避免引 GSAP 级重量
|
||
- **对齐**: 竞品卡片 hover 用 500ms 缩放过渡;Toss 用 Motion 做页面过渡——我们先以 CSS 达到同等观感
|
||
|
||
### 优先级排序建议
|
||
`A1 生成进度 > A2 豆子放置 > A4 下载反馈 > A3 颜色闪烁 > A5 页面过渡`
|
||
先补 A1+A4(纯 CSS 可完成,直接对齐竞品基准),再上 A2(anime.js + leafer 引入,差异化亮点),A3/A5 视进度插空。
|
||
|
||
---
|
||
|
||
## 5. 参考资料(可追溯来源)
|
||
|
||
**竞品证据(本地缓存)**
|
||
- `raw/js/PixelBeadGenerator-C4oOWXAT.js` — Canvas 渲染、sonner keyframes、loading 态、Web Worker
|
||
- `raw/js/index-j6j51b9x.js` — 资源清单(bead-grid-canvas、image-cropper 等模块)
|
||
- `raw/showcase-card-region.txt` — 卡片 hover transition 参数
|
||
|
||
**网络来源**
|
||
- LeaferJS 官方性能页: leaferjs.com/ui/guide/performance.html(100 万矩形 1.5s / 比同类快 10 倍)
|
||
- LeaferJS Canvas 基准: github.com/leaferjs/canvas-benchmark(对 Pixi/Konva/Fabric/SVG/HTML)
|
||
- 像素编辑器 Konva→Leafer 迁移实录: cloud.baidu.com/article/4344040(帧率/内存/DrawCall 实测对比)
|
||
- 开源设计器 Gzm Design 选型: leaferjs.com/ui/blog/2026-04-09.html
|
||
- anime vs lottie npm 对比: pkgpulse.com/compare/anime-vs-lottie-web(体积/下载量/健康分)
|
||
- CSS vs Lottie 选型指南: cloversreport.com/guides/css-vs-lottie-how-to-choose-the-right-web-animation
|
||
- 2026 Web 动画工具深潜(Toss/韩日营销页实践): youngju.dev/blog/culture/2026-05-16-web-animation-tools-2026-rive-lottie-spline-motion-gsap-mit-anime-js-theatre-deep-dive.en
|
||
- MDN 动画性能: developer.mozilla.org/en-US/docs/Web/Performance/Guides/CSS_JavaScript_animation_performance
|
||
- dotLottie 压缩与性能: pkgpulse.com/guides/lottie-vs-rive-vs-css-animations-web-animation-formats-2026;8awake.com
|
||
- 独立工具案例: Novaboard(novaboard.app/zh-cn)、PixelCraft(github.com/gitstq/PixelCraft)、ud5.com 像素生成器、ebtool.com Lottie 预览器、LottieFiles Creator
|
||
|
||
## 6. 关键洞察(一句话给前端)
|
||
|
||
竞品的"高级感"不是靠重量级动画库,而是**原生 Canvas 渲染 + CSS 合成层过渡 + Web Worker 过程可视化 + 克制的 200-500ms 节奏**;我们的升级路径 = 先用 CSS 对齐这四条基准线,再用 **leafer.js(图纸渲染)+ anime.js(豆子/微交互)** 做出竞品没有的差异化动效,Lottie 仅在有设计师资源时引入品牌层。
|