Communitygithub.com

高級滾動動畫技能

使用 Lenis、GSAP 或 Framer Motion 實現高端流暢滾動與複雜觸發動畫。適用於需要動態元素隨滾動顯現或變化的 Premium 層級網站。

高級滾動動畫技能 是什麼?

此技能專為需要「Premium 2D」或更高層級網站的專案設計,提供一套完整的高端滾動動畫解決方案。它基於 Lenis 建立流暢滾動基礎,並利用 Framer Motion 實現淡入、視差、延遲列表等效果,適合打造類似 Apple 產品發表的故事型登陸頁面。技能涵蓋從安裝依賴、配置 Lenis 到應用三種核心動畫模式的完整工作流程,並要求開發者以本地化語言(約旦/巴勒斯坦方言)與使用者溝通,說明技術選擇。支援平台包括 Next.js 等現代 React 框架,並提供可直接複製的程式碼範例與檢查清單。

相容平台~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 技能要求「Premium 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 容器中,並對內層的 motion.img 套用 y 轉換。

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.

相關技能