finktheartist/sakuga-vfx
开发工具一组十二个单文件 Web 组件,按钮、开关、输入框等控件在交互时会迸发手绘动画特效。
项目介绍
Sakuga VFX 把普通表单控件变成小小的动画演出。控件静止时外观朴素,一旦按下、切换或拖动,就会像动画原画里的受击反应一样压扁、回弹,并甩出烟雾、冲击波、碎晶、斩击和拟声词(ドン!、ズザッ)等效果。仓库提供十二种控件:按钮、开关、滑块、复选框、单选框、输入框、标签页、进度条、评分、提示条和工具提示,每种都实现为一个独立的原生自定义元素。
所有特效都由代码画在一张覆盖页面的 canvas 上,拟声词字形和开关帧图直接内置在组件文件里,不在运行时下载。项目面向想给界面加入活泼或动画风质感的前端开发者和设计师,适合直接嵌入,而不是引入整套框架。
快速使用
最快的体验方式是打开在线画廊 https://sakuga-vfx.vercel.app。本地运行则在仓库根目录启一个 HTTP 服务,再访问画廊:
python3 -m http.server 8000
# 打开 http://localhost:8000/
把某个控件加进自己的页面时,可用 shadcn CLI 安装单个文件:
npx shadcn add finktheartist/sakuga-vfx/button
随后加载文件并使用自定义元素:
<script src="button.js"></script>
<sakuga-button>Confirm</sakuga-button>
开关、滑块、复选框、单选框、输入框和评分这类取值控件可以像原生控件一样放进 <form>。每个组件目录都有自己的 README,说明属性、方法和事件;面向编程智能体的 llms.txt 列出了所有文件。
使用约束与已知限制
- 只在无头 Chromium 中用模拟触摸和键盘事件测试过。Safari、Firefox、真机和读屏软件均未验证。
- 每个组件文件都内嵌一份约 40 KB 的核心代码;第一个加载的文件会设置
window.SakugaFX,后续文件复用,因此页面共用一张 canvas 和一个动画循环。开关约 500 KB,因为它的 43 帧图内嵌其中。 - 特效用最高 z-index 覆盖在页面最上层且不接收指针事件,效果可能飘到弹窗和吸顶栏之上。画在控件背后的效果会被带
overflow: hidden的父元素裁掉。 - 开启减少动态效果后,所有特效关闭,但弹簧动画和状态变化保留。
- 许可证为 MIT。拟声词字形和开关帧图使用 GPT Image 生成。
定制方式
控件颜色通过 --sk-ink、--sk-card、--sk-pri、--sk-acc 等 CSS 变量控制,在页面的 :root 里赋值即可覆盖默认值。仓库还附带一套给编程智能体用的技能,包含核心代码、最小示例和逐帧截图脚本,便于仿照制作自己的特效。
HotRepo 点评
Sakuga VFX 于 2026-11-17 进入 HotRepo 新项目榜,统计窗口自 2026-11-16 开始,期间新增 90 个 Star,使总数从约 101 升到 191。它的特别之处在于把视觉打磨做成免依赖的单文件 HTML/JS,而不是组件库;限制也写得很实在:仅测过无头 Chromium,特效可能盖住弹窗,开关文件偏大。它更适合原型和轻松的界面,在浏览器兼容和读屏支持补齐之前,不适合无障碍要求高的应用。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- kevintngo/looseleaf一套手绘纸张风格的 React 组件库,提供 123 个可访问组件并通过 shadcn 注册表分发。
- juliangarnier/anime一个轻量 JavaScript 动画库,用来给 CSS、SVG、DOM 属性和普通对象加脚本控制的动效。
- Secretmakewomenwomen/auric-ui面向 AI 助手工作台与编辑器界面的 React 19 组件库,附带编程 Agent Skill。
- emilkowalski/skills为设计者和工程师提供界面与动效设计规则的 Agent 技能集合,帮助编程助手做出更合适的 UI 决策。
- react/react一个用组件描述状态的 JavaScript UI 库,前端团队在选择渲染层时绕不开的默认选项。