# LayoutMotion **Repository Path**: qqzy1234/layout-motion ## Basic Information - **Project Name**: LayoutMotion - **Description**: 基于 GSAP 的 Vue 3 / Nuxt 4 动画组件库,提供多种炫酷的动画效果组件。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: https://qqzy1234.github.io/layoutMotionDoc/ - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-05-16 - **Last Updated**: 2026-09-04 ## Categories & Tags **Categories**: Uncategorized **Tags**: gsap, animation, Vue, Nuxt ## README # LayoutMotion 基于 GSAP 的 Vue 3 / Nuxt 4 动画组件库,提供多种炫酷的动画效果组件。 ## 特性 - 🎨 **丰富的动画组件** - 包含边框动画、视差背景、遮罩卡片、打字机效果等 - 🚀 **Vue 3 & Nuxt 4 支持** - 提供 Vue 3 插件和 Nuxt 模块 - 📦 **开箱即用** - 组件封装完整,直接使用 - 🎯 **TypeScript 支持** - 完整的类型定义 - 🎭 **Tailwind CSS 兼容** - 支持 Tailwind CSS v4 ## 安装 ### Vue 3 项目 ```bash # npm npm install @qqzy1234/layout-motion-core @qqzy1234/layout-motion-vue # yarn yarn add @qqzy1234/layout-motion-core @qqzy1234/layout-motion-vue # pnpm pnpm add @qqzy1234/layout-motion-core @qqzy1234/layout-motion-vue ``` ### Nuxt 项目 ```bash # npm npm install @qqzy1234/layout-motion-core @qqzy1234/layout-motion-nuxt # yarn yarn add @qqzy1234/layout-motion-core @qqzy1234/layout-motion-nuxt # pnpm pnpm add @qqzy1234/layout-motion-core @qqzy1234/layout-motion-nuxt ``` ## 快速开始 ### Vue 3 ```typescript // main.ts import { createApp } from 'vue' import App from './App.vue' import LayoutMotion from '@qqzy1234/layout-motion-vue' app.use(LayoutMotion) app.mount('#app') ``` ```vue ``` ### Nuxt ```typescript // nuxt.config.ts export default defineNuxtConfig({ modules: [ '@qqzy1234/layout-motion-nuxt' ] }) ``` ## 组件列表 | 组件 | 说明 | |------|------| | `BaseGrowBorder` | 边框生长动画,鼠标悬停时边框从中心向两侧展开 | | `SideGrowBorder` | 侧边边框生长动画,支持单侧、双侧、四侧效果 | | `PointRadialBorder` | 点状径向边框动画 | | `BgParallax` | 背景视差效果,支持固定和非固定模式 | | `HeadChange` | 标题切换动画,文字淡入淡出效果 | | `HeadMaskChange` | 标题遮罩切换动画 | | `MaskFlipCard` | 遮罩翻转卡片,鼠标悬停翻转显示内容 | | `MaskMovCard` | 遮罩移动卡片,鼠标移动时产生遮罩跟随效果 | | `MaskPopCard` | 遮罩弹出卡片 | | `HexagonMatrix` | 六边形矩阵布局 | | `Typewriter` | 打字机效果 | | `Column` / `Row` | 布局容器组件 | ## 开发 ### 环境要求 - Node.js >= 22.0.0 - npm >= 11.6.2 ### 本地开发 ```bash # 安装依赖 npm install # 构建所有包 npm build # 开发模式 - 监听所有包 npm dev # 开发 Nuxt 演示应用 npm dev:nuxt-app # 开发 Vue 演示应用 npm dev:vue-app ``` ### 项目结构 ``` LayoutMotion/ ├── packages/ │ ├── core/ # 核心组件库 │ ├── vue/ # Vue 3 插件封装 │ └── nuxt/ # Nuxt 模块 └── playgrounds/ ├── nuxt-app/ # Nuxt 演示应用 └── vue-app/ # Vue 演示应用 ``` ## 技术栈 - [Vue 3](https://vuejs.org/) - 渐进式 JavaScript 框架 - [Nuxt 4](https://nuxt.com/) - Vue.js 全栈框架 - [GSAP](https://gsap.com/) - 专业级 JavaScript 动画库 - [Tailwind CSS v4](https://tailwindcss.com/) - 实用优先的 CSS 框架 - [tsdown](https://github.com/rolldown/tsdown) - 基于 Rolldown 的 TypeScript 打包工具 ## 许可证 MIT License © 2025 layout-motion