auto-animate

零配置多框架动画引擎,智能防错

🥥60总安装量 15评分人数 9
100% 的用户推荐

基于 FormKit 官方库的零配置动画方案,系统预防 15 个常见错误,支持 React/Vue/Svelte 等多框架 SSR 安全部署。

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 通过全部安全检测,无 eval/exec/system 等危险函数,无 SQL 注入或命令注入漏洞
  • ✅ 依赖来源可靠,使用 FormKit 官方维护的 @formkit/auto-animate npm 包,无已知 CVE 漏洞
  • ✅ 无用户数据收集行为,不收集敏感信息,无静默网络传输与文件上传功能
  • ✅ 脚本执行安全,使用标准包管理器安装依赖,无破坏性系统命令(rm -rf 等)
  • ⚠️ 来源等级为 T3(社区/个人开发者),建议验证安装脚本并确保从官方 npm registry 拉取依赖

使用说明

AutoAnimate 技能为前端开发者提供了一套基于 @formkit/auto-animate 的零配置动画解决方案,专注于列表重排、手风琴展开、Toast 通知等常见 UI 动效场景。该技能的核心价值在于不仅提供了极简的 API 调用方式(仅需一行代码即可为容器添加智能动画),更重要的是系统性地总结了 15 个官方 GitHub Issues 中记录的高频错误,包括 React 19 StrictMode 双调用 Bug、Next.js/Cloudflare Workers 的 SSR 导入错误、Flexbox 容器抖动、条件渲染父元素失效等,并提供了对应的预防代码模板。

该方案的显著优势在于其极低的接入成本与多框架兼容性。作为仅 3.28kb 的轻量库,它支持 React、Vue、Solid、Svelte 和 Preact,且内置了对 prefers-reduced-motion 的自动响应,确保可访问性合规。技能中提供的 SSR-Safe Pattern 通过动态导入(dynamic import)结合 typeof window 判断,彻底解决了服务端渲染环境下的 DOM API 报错问题,这对于使用 Next.js、Nuxt 3 或 Cloudflare Workers 的开发者尤为关键。

然而,该技能也存在明确的局限性。首先,它仅适合简单的显示/隐藏和排序动画,对于需要复杂手势交互(拖拽/滑动)、弹簧物理效果或滚动触发视差动画的场景,官方明确建议使用 motion-react 等更强大的库替代。其次,使用该技能需要严格遵守"父元素必须始终挂载"、"子元素使用唯一稳定 key"、"避免在 Flexbox 中使用 flex-grow"等约束,否则极易触发视觉异常。

目标用户群体主要为追求开发效率的前端工程师,特别是那些需要快速为管理后台、表单列表、通知中心添加丝滑动效,但又不想引入重型动画库的项目团队。对于教育类、企业级后台类产品尤为适合。

使用风险方面,除常规的 npm 依赖版本锁定外,需特别注意 React 19 环境下 StrictMode 的重复挂载问题(skill 已提供 useRef 标记解决方案),以及拖拽排序时必须手动移除 ref 以避免与 HTML5 Drag and Drop API 冲突。此外,虽然安全评级为 A 级,但来源属于 T3 社区级别,建议在使用前验证 scripts/init-auto-animate.sh 脚本内容,确保 npm 包仅从官方 registry 安装,避免供应链攻击。

auto-animate 内容

.claude-plugin文件夹
assets文件夹
references文件夹
scripts文件夹
templates文件夹
手动下载zip · 33.0 kB
plugin.jsonapplication/json
请选择文件