Files

168 lines
14 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 拼豆图纸生成器 · 竞品动画与交互研究
> 调研日期: 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 仅在有设计师资源时引入品牌层。