用途:为 Nuxt 3/4 项目构建或审查基于 GSAP 的动画,涵盖页面过渡(pageTransition)、布局过渡(layoutTransition)、组件进出场、滚动效果、keepalive 与资源清理。
主要能力:围绕 mount → initial state → intro → settled → outro → end state → unmount 的流程组织动画,其中挂载与卸载归 Vue,动画负责中间五个阶段。页面离开时组件会被销毁但根元素保留至结束,因此过渡钩子(css: false)需独立于组件清理来掌控 outro。技能还涉及初始化与恢复、导航(页面 key、keepalive、滚动与焦点、前进后退、View Transitions、SSR 与首屏)、生命周期实现、平滑滚动、过渡原型、设备与输入、验证等主题。
使用方式:先阅读仓库说明、现有动画、布局、导航、CSS、无障碍约定与检查项;确认项目为带 pages/ 目录的 Nuxt,若为纯 Vue + Vue Router 则说明不适用并改用 gsap-frameworks。从 node_modules 读取已安装的 Nuxt、Vue、Vue Router 版本,优先使用已安装类型与对应版本文档。检查 nuxt.config 中的 ssr、srcDir、app.pageTransition、app.layoutTransition、app.keepalive、experimental.viewTransition、future.compatibilityVersion 等配置。GSAP 仅在客户端运行,需用 import.meta.client、onMounted 或 <ClientOnly> 保护,并限定选择器作用域、清理所有 tween、trigger、split 与监听器。
限制与注意:每个元素只使用一种引擎,不要在同一次导航上同时运行 Vue 钩子与 view transition。必须在 onComplete、onInterrupt 以及 reduced motion 下同步调用 done,否则旧页面会一直留在 DOM 中。服务端渲染页面不要使用 appear。需保留原生链接行为、焦点、滚动与无 JavaScript 可读性。资料未提供具体安装命令、价格或平台信息。