Communitygithub.com

Amazinggear/EVO-Ride-Hailing

实现高端、流畅的滚动效果以及复杂的滚动触发动画,基于 Lenis、GSAP 或 Framer Motion。适用于构建需要动态元素在滚动时显示或变换的高级(Premium)层级网站。

EVO-Ride-Hailing 是什么?

该技能专注于为“高级 2D”或更高层级的网站实现高端滚动动画。它使用 Lenis 库提供平滑滚动基础,并结合 Framer Motion 实现组件级的动画效果,例如淡入上移、视差图像和交错列表。当 tier-based-architecture 技能要求高级网站或用户期望类似 Apple 产品发布页面的叙事式滚动效果时,应使用此技能。该Markdown文档详细说明了在 Next.js 项目中安装和配置 Lenis 与 Framer Motion 的步骤,提供了具体的动画模式代码示例,并包含一个工作流程检查清单,确保平滑滚动基础和所有动画正确集成。沟通时要求使用约旦/巴勒斯坦方言,以专业且亲切的方式解释技术选择。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Amazinggear/EVO-Ride-Hailing/tree/HEAD/.agent/skills/advanced-scroll-animations

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

高级滚动动画技能

何时使用此技能

  • 当 tier-based-architecture 技能要求构建“高级 2D”或更高层级的网站时。
  • 当用户希望元素随着页面滚动而淡入、上滑、缩放或固定时。
  • 当构建以叙事为导向的着陆页时(例如,Apple 风格的产品展示)。

语气与语言指南(关键)

  • 始终使用本地约旦/巴勒斯坦方言(اللهجة الأردنية والفلسطينية)与用户沟通。
  • 保持专业且平易近人:"يا هلا","رتبتلك السكرول","الأنيميشن صار جاهز"。
  • 自然地用阿拉伯语混合英语网络术语解释技术选择:"رح نستخدم Framer Motion عشان حركات السكرول تطلع Smooth"。

1. 搭建与基础

如果缺少这些库,请安装:@studio-freight/lenis(用于平滑滚动基础)和 framer-motion(用于组件级动画)。

Lenis 平滑滚动配置

使用此技能的每个网站必须具有平滑滚动基础,以确保动画具有高级感。

  • 在顶层组件(例如 SmoothScrollProvider.tsx 或 layout.tsx)中设置 Lenis。
// 示例 Lenis 设置
"use client";
import React, { useEffect } from 'react';
import Lenis from '@studio-freight/lenis';

export default function SmoothScroll({ children }: { children: React.ReactNode }) {
  useEffect(() => {
    const lenis = new Lenis({
      duration: 1.2,
      easing: (t) => Math.min(1, 1.001 - Math.pow(2, -10 * t)),
      orientation: 'vertical',
      gestureOrientation: 'vertical',
      smoothWheel: true,
      wheelMultiplier: 1,
      touchMultiplier: 2,
    });

    function raf(time: number) {
      lenis.raf(time);
      requestAnimationFrame(raf);
    }
    requestAnimationFrame(raf);

    return () => {
      lenis.destroy();
    };
  }, []);

  return <>{children}</>;
}

2. 动画模式(Framer Motion)

在构建区块时,请使用以下模式以获得高级感:

A. “淡入上移揭示”

用于标题和大型文本块进入视口时的效果。

  • Hook: useInView 或 <motion.div whileInView={...} viewport={{ once: true, margin: "-10%" }}>
  • 初始状态: opacity: 0, y: 40
  • 动画状态: opacity: 1, y: 0
  • 过渡: duration: 0.8, ease: [0.16, 1, 0.3, 1](自定义缓动对于高级感至关重要)。

B. “视差图像”

图像应比滚动位置移动得稍慢或稍快。

  • Hook: useScroll 和 useTransform。
  • 实现:
const { scrollYProgress } = useScroll({ target: containerRef, offset: ["start end", "end start"] });
const y = useTransform(scrollYProgress, [0, 1], ["-20%", "20%"]);
  • 将图像包裹在带有 overflow-hidden 的容器中,并将 y 变换应用于内部的 motion.img。

C. “交错列表”

适用于功能网格、团队成员列表或定价卡片。

  • 父级: <motion.div variants={containerVariants} initial="hidden" whileInView="show" viewport={{ once: true }}>
  • 变体(父级): { hidden: { opacity: 0 }, show: { opacity: 1, transition: { staggerChildren: 0.1 } } }
  • 变体(子项): { hidden: { opacity: 0, y: 20 }, show: { opacity: 1, y: 0, transition: { duration: 0.5, ease: "easeOut" } } }

3. 工作流程检查清单

  1. 复制说明。
  2. 确认 Lenis 是否已安装/配置。如果没有,请先设置。
  3. 对文本内容应用标准的淡入上移揭示效果。
  4. 为大型媒体资产(图片/视频背景)添加视差效果。
  5. 为列表/网格添加交错揭示效果。
  6. 构建项目,验证没有 TypeScript 或 Framer Motion 版本不匹配错误。
  7. 告知用户:"خلصت يا سيدي.. ضفتلك حركات السكرول والـ Lenis، جرب اعمل سكرول بالصفحة وشوف كيف النعومة والشغل النظيف."

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能