Three.js 基礎学習⑧|Three.jsとGSAP・ScrollTriggerの連携
目次
1. 今回の学習内容
これまでの学習では、Three.js単体で3Dモデルを表示し、マウスやスクロールに合わせて動かす方法を学びました。
今回は、そこにGSAPを組み合わせていきます。
GSAPを使用すると、複数のアニメーションを時間軸に沿って管理したり、スクロール位置に合わせてアニメーションを制御したりできます。
例えば、次のような表現が可能になります。
- スクロールに合わせて3Dモデルが回転する
- カメラがモデルに近づいたり、離れたりする
- 3Dモデルが画面の中央から左右に移動する
- テキストがフェードインする
- 複数のアニメーションを連続して実行する
- スクロールを戻すとアニメーションも逆再生される
Three.jsが3D表現を担当し、GSAPがアニメーションの制御を担当するイメージです。
2. GSAPとは何か?
2-1. GSAPの基本
GSAPとは、JavaScriptでアニメーションを制作するためのライブラリです。
正式名称は「GreenSock Animation Platform」です。
CSSだけでもアニメーションは制作できますが、GSAPを使うと、より細かいタイミングや動きを制御できます。
例えば、次のようなコードです。
1//js
2
3gsap.to(".box", {
4
5 x: 300,
6
7 duration: 2
8
9});
このコードは、`.box`というクラスを持つ要素を、2秒かけてX方向に300px移動させます。
それぞれの意味を確認しましょう。
| プロパティ | 意味 |
|---|---|
| `gsap.to()` | 現在の状態から指定した状態へ変化させる |
| `.box` | アニメーションさせる対象 |
| `x` | 横方向の移動距離 |
| `duration` | アニメーションにかける時間 |
GSAPには、主に次の3つの基本メソッドがあります。
2-2. gsap.to()
現在の状態から、指定した状態へアニメーションさせます。
1//js
2
3gsap.to(".box", {
4
5 x: 300,
6
7 opacity: 0,
8
9 duration: 2
10
11});
要素を右に300px移動させながら、透明にしていきます。
2-3. gsap.from()
指定した状態から、現在の状態へアニメーションさせます。
1//js
2
3gsap.from(".box", {
4
5 x: -300,
6
7 opacity: 0,
8
9 duration: 2
10
11});
最初は左側にあり、透明な状態から始まります。
そこから本来の位置に移動しながら表示されます。
2-4. gsap.fromTo()
開始時と終了時の状態を両方指定できます。
1//js
2
3gsap.fromTo(
4
5 ".box",
6
7
8
9 {
10
11 x: -300,
12
13 opacity: 0
14
15 },
16
17
18
19 {
20
21 x: 300,
22
23 opacity: 1,
24
25 duration: 2
26
27 }
28
29);
`fromTo()`は、開始地点と終了地点を明確に決めたい場合に便利です。
3. Timelineで複数のアニメーションを管理する
3-1. Timelineとは?
Timelineとは、複数のアニメーションを時間軸に沿って管理する機能です。
例えば、次のような演出を作るとします。
- 1. タイトルが表示される
- 2. 説明文が表示される
- 3. ボタンが表示される
これらを個別に設定することもできますが、Timelineを使えば一連の流れとして管理できます。
1//js
2
3const tl = gsap.timeline();
4
5
6
7tl.from(".title", {
8
9 y: 50,
10
11 opacity: 0,
12
13 duration: 1
14
15});
16
17
18
19tl.from(".text", {
20
21 y: 30,
22
23 opacity: 0,
24
25 duration: 1
26
27});
28
29
30
31tl.from(".button", {
32
33 y: 20,
34
35 opacity: 0,
36
37 duration: 0.8
38
39});
この場合、基本的には前のアニメーションが終わってから次のアニメーションが始まります。
3-2. アニメーションの開始タイミングを調整する
Timelineでは、3つ目の引数に位置パラメータを指定することで、アニメーションの開始タイミングを調整できます。
1//js
2
3const tl = gsap.timeline();
4
5
6
7tl.from(".title", {
8
9 y: 50,
10
11 opacity: 0,
12
13 duration: 1
14
15});
16
17
18
19tl.from(".text", {
20
21 y: 30,
22
23 opacity: 0,
24
25 duration: 1
26
27}, "-=0.5");
`”-=0.5″`は、直前のアニメーションが終了する0.5秒前から開始するという意味です。
つまり、タイトルが完全に表示される前に、説明文のアニメーションが始まります。
ほかにも、次のような指定があります。
| 指定 | 意味 |
|---|---|
| `”+=0.5″` | 直前のアニメーション終了から0.5秒後 |
| `”-=0.5″` | 直前のアニメーション終了より0.5秒前 |
| `”<"` | 直前のアニメーションと同時に開始 |
| `”>”` | 直前のアニメーションが終了した時点で開始 |
この機能を使うと、複数の要素を自然なタイミングで動かせます。
4. ScrollTriggerとは何か?
4-1. ScrollTriggerの基本
ScrollTriggerは、GSAPのプラグインです。
スクロール位置を基準にして、アニメーションの開始・終了・進行度を制御できます。
例えば、画面に特定のセクションが表示されたタイミングで、アニメーションを開始できます。
1//js
2
3gsap.to(".box", {
4
5 x: 300,
6
7
8
9 scrollTrigger: {
10
11 trigger: ".section",
12
13 start: "top center",
14
15 end: "bottom center"
16
17 }
18
19});
ここで重要なのが`scrollTrigger`です。
4-2. triggerとは?
1//js
2
3trigger: ".section"
アニメーションを制御する基準となるHTML要素を指定します。
今回の場合は、`.section`というクラスを持つ要素が基準になります。
4-3. startとendとは?
1//js
2
3start: "top center",
4
5end: "bottom center"
`start`はアニメーションの開始位置、`end`は終了位置です。
例えば、`start: “top center”`の場合、対象セクションの上端が画面の中央に到達したときが開始位置です。
基本的な指定方法は次のとおりです。
| 指定 | 意味 |
|---|---|
| `top top` | 要素の上端と画面上端が重なる |
| `top center` | 要素の上端と画面中央が重なる |
| `top bottom` | 要素の上端と画面下端が重なる |
| `bottom center` | 要素の下端と画面中央が重なる |
最初の値が対象要素の位置、2つ目の値が画面側の位置です。
4-4. scrubとは?
ScrollTriggerで特に重要なのが`scrub`です。
1//js
2
3scrollTrigger: {
4
5 trigger: ".section",
6
7 start: "top bottom",
8
9 end: "bottom top",
10
11 scrub: 1
12
13}
`scrub`を設定すると、スクロールの進行度とアニメーションの進行度が連動します。
例えば、スクロールを半分進めると、アニメーションもおおよそ半分進みます。
| 設定 | 意味 |
|---|---|
| `scrub: false` | スクロール位置に連動させず、通常のアニメーションとして再生 |
| `scrub: true` | スクロール位置に直接連動 |
| `scrub: 1` | 約1秒かけてスクロール位置に追従 |
| `scrub: 2` | 約2秒かけてスクロール位置に追従 |
` scrub: 1 `のように数値を指定すると、スクロールに対して少し遅れて滑らかに追従する演出になります。
4-5. pinとは?
1//js
2
3scrollTrigger: {
4
5 trigger: ".section",
6
7 start: "top top",
8
9 end: "+=1000",
10
11 pin: true,
12
13 scrub: 1
14
15}
`pin: true`を指定すると、対象セクションを一定期間画面に固定できます。
例えば、セクション自体は画面に固定したまま、スクロールに合わせて3Dモデルだけを動かす演出が可能です。
商品紹介サイトやブランドサイトでよく使われる表現です。
5. Three.jsとGSAPを組み合わせる
5-1. Three.jsのオブジェクトをGSAPで動かす
GSAPはHTML要素だけでなく、JavaScriptのオブジェクトの数値もアニメーションできます。
Three.jsの3Dモデルも例外ではありません。
例えば、モデルの回転を変更する場合は次のように書きます。
1//js
2
3gsap.to(model.rotation, {
4
5 y: Math.PI * 2,
6
7 duration: 3
8
9});
これで、モデルがY軸方向に360度回転します。
同様に、位置や大きさも変更できます。
1//js
2
3// 位置
4
5gsap.to(model.position, {
6
7 x: 2,
8
9 y: 1,
10
11 duration: 2
12
13});
14
15
16
17// 大きさ
18
19gsap.to(model.scale, {
20
21 x: 2,
22
23 y: 2,
24
25 z: 2,
26
27 duration: 2
28
29});
このように、Three.jsのプロパティをGSAPのアニメーション対象として指定できます。
5-2. ScrollTriggerでモデルの回転を制御する
ここからが今回の重要な部分です。
1//js
2
3gsap.to(model.rotation, {
4
5
6
7 y: Math.PI * 2,
8
9
10
11 scrollTrigger: {
12
13 trigger: ".section2",
14
15 start: "top bottom",
16
17 end: "bottom bottom",
18
19 scrub: 1
20
21 }
22
23
24
25});
このコードでは、`.section2`のスクロール位置に合わせてモデルが360度回転します。
`duration`を指定していませんが、`scrub`を使用する場合は、スクロール区間に合わせてアニメーションの進行度が決まります。
5-3. カメラもスクロールに連動させる
Three.jsでは、カメラもJavaScriptのオブジェクトです。
そのため、カメラの位置もGSAPで制御できます。
1//js
2
3gsap.to(camera.position, {
4
5
6
7 z: 3,
8
9
10
11 scrollTrigger: {
12
13 trigger: ".section2",
14
15 start: "top bottom",
16
17 end: "bottom bottom",
18
19 scrub: 1
20
21 }
22
23
24
25});
スクロールに合わせてカメラがZ方向に移動し、モデルに近づいていきます。
ただし、カメラを移動させるとモデルの見える位置も変わるため、必要に応じて`camera.lookAt()`の向きも調整します。
6. 実践|Three.js × GSAPのスクロール演出を作る
ここまでの内容を組み合わせて、実際に動くWebページを制作します。
今回の完成イメージは次のとおりです。
- 画面いっぱいに3Dモデルを表示する
- スクロールに合わせてモデルが回転する
- モデルが左右に移動する
- カメラがモデルに近づく
- HTMLのタイトルと説明文がフェードインする
- セクションを一定期間固定する
6-1. ファイル構成
今回はHTMLファイル1つで動作するようにします。
1//text
2
3three-gsap/
4
5└── index.html
6-2. HTML・CSS・JavaScript
以下を`index.html`にコピーしてください。
1<!--html-->
2
3<!DOCTYPE html>
4
5<html lang="ja">
6
7
8
9<head>
10
11 <meta charset="UTF-8">
12
13 <meta name="viewport" content="width=device-width, initial-scale=1.0">
14
15
16
17 <title>Three.js × GSAP</title>
18
19
20
21 <style>
22
23 * {
24
25 margin: 0;
26
27 padding: 0;
28
29 box-sizing: border-box;
30
31 }
32
33
34
35 body {
36
37 background: #111318;
38
39 color: #fff;
40
41 font-family: sans-serif;
42
43 }
44
45
46
47 #webgl {
48
49 position: fixed;
50
51 inset: 0;
52
53 z-index: 0;
54
55 pointer-events: none;
56
57 }
58
59
60
61 .hero {
62
63 position: relative;
64
65 z-index: 1;
66
67 height: 100vh;
68
69
70
71 display: flex;
72
73 flex-direction: column;
74
75 justify-content: center;
76
77
78
79 padding: 10%;
80
81 pointer-events: none;
82
83 }
84
85
86
87 .hero h1 {
88
89 font-size: clamp(48px, 8vw, 110px);
90
91 letter-spacing: 0.05em;
92
93 }
94
95
96
97 .hero p {
98
99 margin-top: 20px;
100
101 color: #aaa;
102
103 line-height: 2;
104
105 }
106
107
108
109 .scroll-section {
110
111 position: relative;
112
113 z-index: 1;
114
115
116
117 height: 150vh;
118
119
120
121 display: flex;
122
123 align-items: center;
124
125
126
127 padding: 10%;
128
129 pointer-events: none;
130
131 }
132
133
134
135 .content {
136
137 max-width: 500px;
138
139 }
140
141
142
143 .content h2 {
144
145 font-size: clamp(36px, 6vw, 80px);
146
147 margin-bottom: 20px;
148
149 }
150
151
152
153 .content p {
154
155 color: #aaa;
156
157 line-height: 2;
158
159 }
160
161
162
163 .section2 {
164
165 justify-content: flex-end;
166
167 text-align: right;
168
169 }
170
171
172
173 .section3 {
174
175 justify-content: center;
176
177 text-align: center;
178
179 }
180
181
182
183 .label {
184
185 color: #c5a779;
186
187 font-size: 12px;
188
189 letter-spacing: 0.2em;
190
191 margin-bottom: 20px;
192
193 }
194
195
196
197 .footer {
198
199 position: relative;
200
201 z-index: 1;
202
203 height: 60vh;
204
205
206
207 display: flex;
208
209 justify-content: center;
210
211 align-items: center;
212
213
214
215 color: #aaa;
216
217 }
218
219 </style>
220
221</head>
222
223
224
225<body>
226
227
228
229 <div id="webgl"></div>
230
231
232
233 <section class="hero">
234
235 <div class="label">DIGITAL EXPERIENCE</div>
236
237 <h1>BEYOND<br>THE SPACE</h1>
238
239 <p>
240
241 Scroll to explore a new dimension.
242
243 </p>
244
245 </section>
246
247
248
249 <section class="scroll-section section1">
250
251 <div class="content">
252
253 <div class="label">01 / MOVEMENT</div>
254
255 <h2>Movement</h2>
256
257 <p>
258
259 3D objects move through the digital space.
260
261 Scroll to experience the movement.
262
263 </p>
264
265 </div>
266
267 </section>
268
269
270
271 <section class="scroll-section section2">
272
273 <div class="content">
274
275 <div class="label">02 / TRANSFORMATION</div>
276
277 <h2>Transform</h2>
278
279 <p>
280
281 A new perspective changes the way
282
283 we experience the world.
284
285 </p>
286
287 </div>
288
289 </section>
290
291
292
293 <section class="scroll-section section3">
294
295 <div class="content">
296
297 <div class="label">03 / EXPERIENCE</div>
298
299 <h2>Experience</h2>
300
301 <p>
302
303 Create a new experience
304
305 through interaction.
306
307 </p>
308
309 </div>
310
311 </section>
312
313
314
315 <footer class="footer">
316
317 END OF EXPERIENCE
318
319 </footer>
320
321
322
323
324
325 <script type="importmap">
326
327 {
328
329 "imports": {
330
331 "three": "https://cdn.jsdelivr.net/npm/three@0.170.0/build/three.module.js",
332
333 "gsap": "https://cdn.jsdelivr.net/npm/gsap@3.12.5/index.js",
334
335 "gsap/ScrollTrigger": "https://cdn.jsdelivr.net/npm/gsap@3.12.5/ScrollTrigger.js"
336
337 }
338
339 }
340
341 </script>
342
343
344
345
346
347 <script type="module">
348
349
350
351 import * as THREE from "three";
352
353
354
355 import { GLTFLoader } from
356
357 "https://cdn.jsdelivr.net/npm/three@0.170.0/examples/jsm/loaders/GLTFLoader.js";
358
359
360
361 import { gsap } from "gsap";
362
363
364
365 import { ScrollTrigger } from "gsap/ScrollTrigger";
366
367
368
369
370
371 // GSAP Plugin
372
373 gsap.registerPlugin(ScrollTrigger);
374
375
376
377
378
379 // Scene
380
381 const scene = new THREE.Scene();
382
383
384
385 scene.background = new THREE.Color("#111318");
386
387
388
389
390
391 // Camera
392
393 const camera = new THREE.PerspectiveCamera(
394
395 45,
396
397 window.innerWidth / window.innerHeight,
398
399 0.1,
400
401 100
402
403 );
404
405
406
407 camera.position.set(0, 1.5, 7);
408
409
410
411
412
413 // Renderer
414
415 const renderer = new THREE.WebGLRenderer({
416
417 antialias: true
418
419 });
420
421
422
423 renderer.setSize(
424
425 window.innerWidth,
426
427 window.innerHeight
428
429 );
430
431
432
433 renderer.setPixelRatio(
434
435 Math.min(window.devicePixelRatio, 2)
436
437 );
438
439
440
441 document
442
443 .getElementById("webgl")
444
445 .appendChild(renderer.domElement);
446
447
448
449
450
451 // Light
452
453 const ambientLight = new THREE.AmbientLight(
454
455 0xffffff,
456
457 2
458
459 );
460
461
462
463 scene.add(ambientLight);
464
465
466
467
468
469 const directionalLight = new THREE.DirectionalLight(
470
471 0xffffff,
472
473 3
474
475 );
476
477
478
479 directionalLight.position.set(3, 5, 5);
480
481
482
483 scene.add(directionalLight);
484
485
486
487
488
489 // Model
490
491 const loader = new GLTFLoader();
492
493
494
495 let model = null;
496
497
498
499 loader.load(
500
501 "https://threejs.org/examples/models/gltf/RobotExpressive/RobotExpressive.glb",
502
503
504
505 (gltf) => {
506
507
508
509 model = gltf.scene;
510
511
512
513 model.scale.set(1.2, 1.2, 1.2);
514
515
516
517 model.position.set(0, -1, 0);
518
519
520
521 scene.add(model);
522
523
524
525 // Scroll Animation
526
527 const tl = gsap.timeline({
528
529
530
531 scrollTrigger: {
532
533 trigger: ".section1",
534
535 start: "top bottom",
536
537 endTrigger: ".section3",
538
539 end: "bottom bottom",
540
541 scrub: 1
542
543 }
544
545
546
547 });
548
549
550
551
552
553 // Rotation
554
555 tl.to(model.rotation, {
556
557 y: Math.PI * 2,
558
559 ease: "none"
560
561 }, 0);
562
563
564
565
566
567 // Move
568
569 tl.to(model.position, {
570
571 x: 2,
572
573 y: 0,
574
575 ease: "none"
576
577 }, 0);
578
579
580
581
582
583 // Camera
584
585 tl.to(camera.position, {
586
587 z: 4,
588
589 ease: "none"
590
591 }, 0);
592
593
594
595
596
597 // Second movement
598
599 tl.to(model.position, {
600
601 x: -2,
602
603 y: 0.5,
604
605 ease: "none"
606
607 }, 0.5);
608
609
610
611
612
613 // Camera return
614
615 tl.to(camera.position, {
616
617 z: 6,
618
619 ease: "none"
620
621 }, 0.5);
622
623
624
625
626
627 ScrollTrigger.refresh();
628
629
630
631 },
632
633
634
635 undefined,
636
637
638
639 (error) => {
640
641 console.error("モデルの読み込みに失敗しました", error);
642
643 }
644
645 );
646
647
648
649
650
651 // Text Animation
652
653 gsap.from(".hero h1", {
654
655 y: 80,
656
657 opacity: 0,
658
659 duration: 1.5,
660
661 ease: "power3.out"
662
663 });
664
665
666
667
668
669 gsap.from(".hero p", {
670
671 y: 30,
672
673 opacity: 0,
674
675 duration: 1,
676
677 delay: 0.5
678
679 });
680
681
682
683
684
685 gsap.utils.toArray(".content").forEach((content) => {
686
687
688
689 gsap.from(content.children, {
690
691
692
693 y: 50,
694
695 opacity: 0,
696
697 duration: 1,
698
699 stagger: 0.2,
700
701 ease: "power3.out",
702
703
704
705 scrollTrigger: {
706
707 trigger: content,
708
709 start: "top 80%",
710
711 toggleActions: "play none none reverse"
712
713 }
714
715
716
717 });
718
719
720
721 });
722
723
724
725
726
727 // Render Loop
728
729 function animate() {
730
731
732
733 requestAnimationFrame(animate);
734
735
736
737 renderer.render(scene, camera);
738
739
740
741 }
742
743
744
745 animate();
746
747
748
749
750
751 // Resize
752
753 window.addEventListener("resize", () => {
754
755
756
757 camera.aspect =
758
759 window.innerWidth / window.innerHeight;
760
761
762
763 camera.updateProjectionMatrix();
764
765
766
767 renderer.setSize(
768
769 window.innerWidth,
770
771 window.innerHeight
772
773 );
774
775
776
777 renderer.setPixelRatio(
778
779 Math.min(window.devicePixelRatio, 2)
780
781 );
782
783
784
785 ScrollTrigger.refresh();
786
787
788
789 });
790
791
792
793 </script>
794
795
796
797</body>
798
799</html>
6-3. コードの重要ポイント
**① GSAPとScrollTriggerを読み込む**
1//js
2
3import { gsap } from "gsap";
4
5
6
7import { ScrollTrigger } from "gsap/ScrollTrigger";
8
9
10
11gsap.registerPlugin(ScrollTrigger);
GSAP本体とScrollTriggerを読み込み、プラグインとして登録しています。
登録を忘れると、ScrollTriggerを正常に利用できません。
**② Timelineを作成する**
1//js
2
3const tl = gsap.timeline({
4
5
6
7 scrollTrigger: {
8
9 trigger: ".section1",
10
11 start: "top bottom",
12
13 endTrigger: ".section3",
14
15 end: "bottom bottom",
16
17 scrub: 1
18
19 }
20
21
22
23});
ここでは、`.section1`からアニメーションを開始し、`.section3`の下端が画面下端に到達するまでをアニメーション区間にしています。
`endTrigger`を指定することで、開始位置と終了位置の基準を別々の要素にできます。
**③ Timelineに3Dモデルのアニメーションを追加する**
1//js
2
3tl.to(model.rotation, {
4
5 y: Math.PI * 2,
6
7 ease: "none"
8
9}, 0);
モデルのY軸回転を360度変化させます。
最後の`0`は、Timelineの開始位置を指定しています。
続けて、次のアニメーションも同じタイミングで追加できます。
1//js
2
3tl.to(model.position, {
4
5 x: 2,
6
7 y: 0,
8
9 ease: "none"
10
11}, 0);
これによって、モデルの回転と移動を同時に進められます。
**④ アニメーションの途中から別の動きを追加する**
1//js
2
3tl.to(model.position, {
4
5 x: -2,
6
7 y: 0.5,
8
9 ease: "none"
10
11}, 0.5);
`0.5`はTimeline全体の途中の位置を表します。
この例では、アニメーションの半分あたりからモデルを左側へ移動させます。
`ease: “none”`は、加速や減速を付けず、一定の進行速度にする指定です。
スクロール連動では、スクロール量と動きの関係を分かりやすくするためによく使います。
**⑤ テキストを順番に表示する**
1//js
2
3gsap.from(content.children, {
4
5 y: 50,
6
7 opacity: 0,
8
9 duration: 1,
10
11 stagger: 0.2
12
13});
`content.children`は、対象となるHTML要素の子要素をまとめて取得しています。
`stagger: 0.2`によって、各要素のアニメーション開始タイミングを0.2秒ずつずらしています。
これによって、ラベル・見出し・説明文が順番に表示されます。
**⑥ toggleActionsとは?**
1//js
2
3toggleActions: "play none none reverse"
これは、スクロールによって要素が表示領域に入ったり出たりしたときの動作を指定するものです。
指定できる4つのタイミングは次のとおりです。
| 順番 | タイミング |
|---|---|
| 1つ目 | スクロールして開始位置に入ったとき |
| 2つ目 | 終了位置を通過したとき |
| 3つ目 | スクロールを戻して終了位置を通過したとき |
| 4つ目 | スクロールを戻して開始位置を通過したとき |
今回の`play none none reverse`は、表示時に再生し、逆方向に戻ったときに逆再生する設定です。
7. よく使うGSAP・ScrollTriggerの設定
実際のWebサイト制作でも使いやすい設定をまとめます。
7-1. イージング
イージングとは、アニメーションの加速や減速を調整する仕組みです。
1//js
2
3gsap.to(".box", {
4
5 x: 300,
6
7 duration: 2,
8
9 ease: "power3.out"
10
11});
代表的なイージングはこちらです。
| イージング | 特徴 |
|---|---|
| `none` | 一定速度 |
| `power1.out` | 穏やかに減速 |
| `power2.out` | 自然な減速 |
| `power3.out` | 強めの減速 |
| `power4.out` | 大きく減速 |
| `back.out` | 少し行き過ぎて戻る |
| `elastic.out` | 弾むような動き |
7-2. ScrollTriggerの代表的な設定
| 設定 | 役割 |
|---|---|
| `trigger` | 基準となる要素 |
| `start` | アニメーション開始位置 |
| `end` | アニメーション終了位置 |
| `scrub` | スクロールと連動 |
| `pin` | 要素を固定 |
| `markers` | 開始・終了位置を可視化 |
| `toggleActions` | 表示・非表示時の動作 |
| `endTrigger` | 終了位置の基準となる要素 |
開発中は`markers: true`を付けると便利です。
1//js
2
3scrollTrigger: {
4
5 trigger: ".section",
6
7 start: "top center",
8
9 end: "bottom center",
10
11 scrub: 1,
12
13 markers: true
14
15}
ブラウザ上に開始位置と終了位置が表示されるため、スクロールのタイミングを調整しやすくなります。
完成したら`markers`は削除しましょう。
8. 実践課題
今回のコードを使って、次の変更にも挑戦してみましょう。
課題①:モデルの回転量を増やす
1//js
2
3tl.to(model.rotation, {
4
5 y: Math.PI * 4,
6
7 ease: "none"
8
9}, 0);
360度ではなく720度回転するようになります。
課題②:カメラをさらに近づける
1//js
2
3tl.to(camera.position, {
4
5 z: 2.5,
6
7 ease: "none"
8
9}, 0);
モデルに近づく演出になります。
課題③:モデルを大きくする
1//js
2
3tl.to(model.scale, {
4
5 x: 2,
6
7 y: 2,
8
9 z: 2,
10
11 ease: "none"
12
13}, 0);
スクロールに合わせてモデルが拡大します。
課題④:セクションを固定する
1//js
2
3scrollTrigger: {
4
5 trigger: ".section1",
6
7 start: "top top",
8
9 end: "+=1500",
10
11 pin: true,
12
13 scrub: 1
14
15}
対象のセクションを固定しながら、1500px分のスクロール区間でアニメーションを進めます。
9. Three.jsとGSAPを使う際の注意点
9-1. 同じプロパティを複数のアニメーションで動かさない
例えば、同じモデルの`rotation.y`を複数のScrollTriggerで同時に制御すると、アニメーション同士が競合する可能性があります。
1//js
2
3// 注意:同じrotation.yを別々のTriggerで制御する例
4
5gsap.to(model.rotation, {
6
7 y: Math.PI,
8
9 scrollTrigger: {
10
11 trigger: ".section1",
12
13 scrub: 1
14
15 }
16
17});
18
19
20
21gsap.to(model.rotation, {
22
23 y: Math.PI * 2,
24
25 scrollTrigger: {
26
27 trigger: ".section2",
28
29 scrub: 1
30
31 }
32
33});
このような場合は、今回の実践コードのように1つのTimelineで管理すると整理しやすくなります。
9-2. モデルの読み込みが終わってからアニメーションを設定する
GLBモデルは読み込みに時間がかかる場合があります。
そのため、モデルを読み込む前に`model.rotation`などを操作するとエラーになります。
今回のコードでは、`loader.load()`の成功時の処理の中でTimelineを作成しています。
このように、モデルが読み込まれてからアニメーションを設定することが重要です。
9-3. ScrollTrigger.refresh()を活用する
画像や3Dモデルの読み込みなどによってページの高さが変わると、ScrollTriggerの開始位置や終了位置がずれることがあります。
そのような場合は、次のコードで位置情報を再計算できます。
1//js
2
3ScrollTrigger.refresh();
今回のコードでは、モデルの読み込み後と画面サイズ変更後に実行しています。
10. まとめ
今回は、Three.jsとGSAPを組み合わせて、スクロールに連動する3Dアニメーションを制作しました。
今回の重要なポイントは次の5つです。
- 1. `gsap.to()`・`gsap.from()`・`gsap.fromTo()`でアニメーションを作る
- 2. `gsap.timeline()`で複数のアニメーションを管理する
- 3. `ScrollTrigger`でスクロールを基準にする
- 4. `scrub`でスクロールとアニメーションを連動させる
- 5. Three.jsの`position`・`rotation`・`scale`・`camera.position`をGSAPで制御する
特に重要なのは、**Three.jsで作った3D空間のオブジェクトも、GSAPのアニメーション対象にできる**という点です。
これを理解すると、3DモデルとHTMLのテキスト、カメラワークを組み合わせた、より本格的なWebサイトを制作できるようになります。
今回の学習で、Three.jsの基礎からスクロール連動アニメーションまで、一通りの基本を学びました。
次の段階では、これらの技術を実際のWebサイト制作に応用していきましょう。















