搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

finktheartist/sakuga-vfx

开发工具

一组十二个单文件 Web 组件,按钮、开关、输入框等控件在交互时会迸发手绘动画特效。

331
33
HTML
MIT
创建于 2 天前

项目介绍

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 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. kevintngo/looseleaf一套手绘纸张风格的 React 组件库,提供 123 个可访问组件并通过 shadcn 注册表分发。TypeScript107
  2. juliangarnier/anime一个轻量 JavaScript 动画库,用来给 CSS、SVG、DOM 属性和普通对象加脚本控制的动效。JavaScript73,924
  3. Secretmakewomenwomen/auric-ui面向 AI 助手工作台与编辑器界面的 React 19 组件库,附带编程 Agent Skill。TypeScript100
  4. emilkowalski/skills为设计者和工程师提供界面与动效设计规则的 Agent 技能集合,帮助编程助手做出更合适的 UI 决策。Markdown54,032
  5. react/react一个用组件描述状态的 JavaScript UI 库,前端团队在选择渲染层时绕不开的默认选项。JavaScript251,745