用途:@formkit/auto-animate(0.9.0,2025 年 9 月)为 React、Vue、Solid、Svelte、Preact 提供零配置动画,自动处理元素增删等 DOM 变化,体积约 3.28kb。
主要能力:通过 autoAnimate(parent) 对父容器启用动画;自动尊重 prefers-reduced-motion,不应关闭该行为。资料同时整理了 10 个已记录问题的预防方法,包括 SSR/Next.js 导入错误、条件渲染父元素、缺少唯一 key、flexbox 宽度、表格行、Jest、esbuild、CSS position 副作用、Vue/Nuxt 指令注册、Angular ESM 等。
使用方式:SSR 环境(如 Next.js、Cloudflare Workers)需客户端动态导入,示例:import("@formkit/auto-animate").then(({ default: autoAnimate }) => { autoAnimate(parent); })。父元素必须始终渲染,列表项使用稳定唯一 key(如 key={item.id}),表格应作用于 tbody 而非单行,动画元素避免 flex-grow 而用显式宽度。
适用场景:列表增删、手风琴、Toast、表单等轻量过渡。
限制:复杂动画建议改用 Motion;父元素会获得 position: relative;Jest、esbuild、Angular 等需额外配置;具体安装命令与完整模板资料未提供。