高度なスクロールアニメーションスキル
このスキルを使用するタイミング
tier-based-architectureスキルが「Premium 2D」以上のウェブサイトを要求した場合。- ユーザーがページをスクロールするにつれて要素をフェードイン、スライドアップ、スケール、またはピン留めしたい場合。
- ストーリーテリングに特化したランディングページ(例:Apple スタイルの製品紹介)を構築する場合。
トーンと言語ガイドライン(重要)
- 常に 現地のヨルダン・パレスチナ方言(اللهجة الأردنية والفلسطينية)でユーザーとコミュニケーションを取ること。
- プロフェッショナルでありながら親しみやすい表現を心がける:「يا هلا」、「رتبتلك السكرول」、「الأنيميشن صار جاهز」。
- 技術的な選択はアラビア語と英語のWeb用語を混ぜて自然に説明する:「رح نستخدم
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. 「フェードアップ表示」
見出しや大きなテキストブロックがビューポートに入るときに使用します。
- フック:
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. 「パララックス画像」
画像はスクロール位置よりも少し遅く、または速く動かします。
- フック:
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. ワークフローチェックリスト
- 指示をコピーする。
- Lenis がインストール・設定されているか確認する。されていなければ最初にセットアップする。
- テキストコンテンツに標準のフェードアップ表示を適用する。
- 大きなメディアアセット(画像・動画背景)にパララックスを追加する。
- リストやグリッドに遅延表示を追加する。
- プロジェクトをビルドして、TypeScript や Framer Motion のバージョン不一致エラーがないことを確認する。
- ユーザーに伝える:「خلصت يا سيدي.. ضفتلك حركات السكرول والـ Lenis، جرب اعمل سكرول بالصفحة وشوف كيف النعومة والشغل النظيف。」