高级滚动动画技能
何时使用此技能
- 当
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. 工作流程检查清单
- 复制说明。
- 确认 Lenis 是否已安装/配置。如果没有,请先设置。
- 对文本内容应用标准的淡入上移揭示效果。
- 为大型媒体资产(图片/视频背景)添加视差效果。
- 为列表/网格添加交错揭示效果。
- 构建项目,验证没有 TypeScript 或 Framer Motion 版本不匹配错误。
- 告知用户:"خلصت يا سيدي.. ضفتلك حركات السكرول والـ Lenis، جرب اعمل سكرول بالصفحة وشوف كيف النعومة والشغل النظيف."