Scrollcraft
Capitolul 8 din 15EN

WebGL: o scenă în spatele paginii.

three.js desenează cu placa video; așa obțin site-urile de agenție adâncime, lumină și particule pe care CSS nu le poate face. Patru scene mai jos, fiecare legată de scroll și rulând live lângă codul ei.

Capitolul 8 din 153 min de citit

Ce vei învăța

La finalul capitolului
  1. 01Pregătești o scenă three.js cu renderer, cameră, lumini și un obiect.
  2. 02Conduci o scenă cu poziția scrollului și desenezi doar când se schimbă ceva.
  3. 03Muți munca pe placa video cu shadere și atribute de buffer.
  4. 04Păstrezi WebGL rapid și sigur: limită de densitate, curățenie, mișcare redusă și variantă de rezervă.

01 · Înainte să începi

Când merită WebGL
a

Folosește-l pentru un singur moment

Un produs pe care îl poți roti, un câmp de lumină, o tranziție între două imagini. O scenă care duce povestea merită greutatea; o scenă în fiecare secțiune, nu.

b

Încarcă-l ca modul

three.js vine ca modul ES. Pe o pagină simplă, un import map îi spune browserului unde se află three; cu un bundler, instalează-l din npm și importă-l la fel.

bash
npm install three
c

Ai mereu o variantă de rezervă

Unele calculatoare nu au WebGL: hardware vechi, sesiuni Remote Desktop, calculatoare de laborator blocate. Creează rendererul într-un try și păstrează pagina lizibilă fără el.

JavaScript
const canvas = document.querySelector('canvas.gl');
let renderer;
try {
  renderer = new THREE.WebGLRenderer({ canvas, antialias: true });
} catch {
  // fără WebGL: spune asta și păstrează pagina lizibilă fără scenă
  document.documentElement.classList.add('no-webgl');
}

02 · Patru scene, live

Derulează în fiecare previzualizare
1

O scenă condusă de scroll

Un obiect, două lumini și o cameră. Poziția scrollului rotește obiectul și apropie camera, iar scena se desenează doar când se schimbă scrollul.

Desenatul la scroll, în loc de o buclă continuă, lasă placa video în repaus cât cititorul citește.

HTML
<script type="importmap">
  { "imports": { "three": "https://cdn.jsdelivr.net/npm/three@0.187.0/build/three.module.js" } }
</script>
<canvas class="gl" aria-hidden="true"></canvas>
<p class="nogl">This device has no WebGL. The page still reads in full.</p>
<main>
  <section><h2>A scene behind the page</h2></section>
  <section><h2>Scroll turns it</h2></section>
  <section><h2>and moves the camera in</h2></section>
</main>
2

Particule mutate pe placa video

Douăsprezece mii de puncte, fiecare cu două poziții. Un mic vertex shader le amestecă după un singur număr, așa că mișcarea nu costă nimic în JavaScript, oricâte puncte ar fi.

Tot ce ai actualiza pentru fiecare punct într-o buclă își are locul într-un atribut de shader și un uniform.

HTML
<script type="importmap">
  { "imports": { "three": "https://cdn.jsdelivr.net/npm/three@0.187.0/build/three.module.js" } }
</script>
<canvas class="gl" aria-hidden="true"></canvas>
<p class="nogl">This device has no WebGL. The page still reads in full.</p>
<main>
  <section><h2>Twelve thousand points</h2></section>
  <section><h2>leave a sphere</h2></section>
  <section><h2>and settle into a wave.</h2></section>
</main>
3

Un shader pe tot ecranul

Un dreptunghi care acoperă ecranul și un fragment shader care colorează fiecare pixel. Zgomotul plutește în timp; scrollul mută lumina de la noapte la zori.

Un fundal difuz se poate desena la densitate 1x. Nimeni nu vede diferența, iar pe un ecran retina costă un sfert din efort.

HTML
<script type="importmap">
  { "imports": { "three": "https://cdn.jsdelivr.net/npm/three@0.187.0/build/three.module.js" } }
</script>
<canvas class="gl" aria-hidden="true"></canvas>
<p class="nogl">This device has no WebGL. The page still reads in full.</p>
<main>
  <section><h2>One shader, full screen</h2></section>
  <section><h2>Time moves it slowly.</h2></section>
  <section><h2>Scroll changes the light.</h2></section>
</main>
4

O tranziție cinematică

Două imagini pe un dreptunghi și un shader care trece de la una la alta de-a lungul unei margini neregulate pe măsură ce derulezi, în timp ce amândouă alunecă puțin: o dizolvare care se citește ca o mișcare de cameră.

Previzualizarea își desenează cele două imagini din cod. Cu fotografii, încarcă-le cu TextureLoader și setează colorSpace pe sRGB.

HTML
<script type="importmap">
  { "imports": { "three": "https://cdn.jsdelivr.net/npm/three@0.187.0/build/three.module.js" } }
</script>
<canvas class="gl" aria-hidden="true"></canvas>
<p class="nogl">This device has no WebGL. The page still reads in full.</p>
<main>
  <section><h2>From one scene</h2></section>
  <section><h2>to the next,</h2></section>
  <section><h2>with a dissolve driven by scroll.</h2></section>
</main>

03 · Păstrează-l rapid

Bugetul
a

Limitează densitatea și desenează la nevoie

Două setări decid cea mai mare parte din cost: câți pixeli desenezi și cât de des. Curăță ce ai creat când scena dispare, altfel un site cu o singură pagină pierde memorie la fiecare vizită.

JavaScript
renderer.setPixelRatio(Math.min(devicePixelRatio, 2)); // peste 2x costul crește, câștigul nu

// desenează doar când s-a schimbat ceva
addEventListener('scroll', () => requestAnimationFrame(render), { passive: true });

// când scena dispare definitiv, eliberează memoria
geometry.dispose();
material.dispose();
texture.dispose();
renderer.dispose();
b

Respectă reducerea mișcării

Fiecare previzualizare citește prefers-reduced-motion: scenele stau pe loc, particulele arată forma finală, shaderul nu mai plutește, iar tranziția taie în loc să se dizolve.

c

Verifică pe un telefon real

Plăcile video de desktop ascund problemele. Deschide pagina pe un telefon de gamă medie, derulează un minut și simte dacă se încălzește. Dacă da, scade întâi densitatea sau numărul de puncte.

Practică · Lucrul cu AI

Aceeași sarcină, în unealta ta

Prompturile pentru WebGL au nevoie de limite mai mult decât oricare altele: AI-ul adaugă bucuros post-procesare și umbre pe care un telefon nu și le permite.

Deschide un terminal în folderul proiectului și rulează claude. Apasă Shift+Tab până se pornește modul plan, lipește promptul, citește planul, apoi aprobă-l. Regulile proiectului stau în CLAUDE.md.

O scenă pentru hero

Prompt
Citește CLAUDE.md. Adaugă o scenă three.js 0.187.0 în spatele hero-ului din site-ul pentru [subiect], încărcată ca modul ES printr-un import map de pe jsDelivr. Un obiect, două lumini, fără umbre, fără post-procesare. Poziția scrollului rotește obiectul și mută camera; desenează doar când se schimbă scrollul. Limitează densitatea la 2, creează rendererul într-un try și arată o imagine statică dacă lipsește WebGL, iar sub prefers-reduced-motion scena stă pe loc.

Verificare de performanță

Prompt
Măsoară scena din hero: timpul pe cadru cât derulezi, numărul de desenări și memoria texturilor. Spune-mi singura schimbare care ar ajuta cel mai mult un telefon de gamă medie. Nu schimba încă nimic.

Practică · Exerciții

Încearcă, apoi compară
1

Desenează la nevoie

Scena desenează de 60 de ori pe secundă chiar și când pagina stă. Schimb-o să deseneze doar când se schimbă scrollul.

Indiciu: cere un singur cadru din listenerul de scroll.

Arată soluția

Scoate bucla continuă și cere un singur cadru când se mișcă scrollul, ca placa video să stea cât cititorul citește.

JavaScript
let queued = false;
function render() {
  queued = false;
  mesh.rotation.y = scrollY * 0.002;
  renderer.render(scene, camera);
}
addEventListener('scroll', () => {
  if (!queued) { queued = true; requestAnimationFrame(render); }
}, { passive: true });
render();
2

Varianta de rezervă

Fă pagina lizibilă pe un calculator fără WebGL.

Indiciu: constructorul rendererului aruncă o eroare când WebGL lipsește.

Arată soluția

Creează rendererul într-un try; în catch, adaugă o clasă pe elementul html care ascunde canvasul și arată o imagine statică sau nimic. Textul nu trebuie să depindă niciodată de scenă.

3

Unde se duce costul

Un hero cu particule merge lin pe laptop și sacadează pe telefon. Listează trei schimbări, de la cea mai ieftină.

Indiciu: pixeli, apoi puncte, apoi efecte.

Arată soluția

1. Limitează densitatea mai jos (1,5 sau 1). 2. Folosește mai puține puncte pe ecrane mici. 3. Scoate trecerile în plus, precum bloom. Măsoară după fiecare schimbare.

Practică · Proiectul cursului

Un site, construit pe tot parcursul

Dacă un moment 3D servește povestea pentru [subiect], adaugă unul. Dacă nu, sari peste pas: și reținerea e o decizie de design.

  1. Decide dacă hero-ul câștigă ceva din adâncime. Scrie motivul în notes.md.
  2. Dacă da, rulează „O scenă pentru hero”, apoi „Verificare de performanță”.
  3. Oprește WebGL în browser (sau testează pe un dispozitiv vechi) și verifică varianta de rezervă.
  4. Fă commit, cu versiunea three.js fixată în import map.

Practică · Testează

Verifici rezultatul
  • Scena desenează doar cât derulezi: panoul Performance e liniștit când pagina stă.
  • Cu WebGL oprit, pagina se citește întreagă, fără erori.
  • Cu mișcarea redusă pornită, scena nu se mișcă.
  • Pe un telefon real, derularea peste hero nu sacadează și nu încălzește dispozitivul.

Practică · Evaluare

Criterii de acceptare

0 din 4 criterii îndeplinite

Urmează Exemple

Cinci proiecte de portofoliu: o lansare de produs, un portofoliu de studio, un articol lung, un studiu de caz în GSAP și un produs în WebGL. Fiecare rulează live, responsive și liniștit cu mișcare redusă, cu brief, prompturi și cod complet.

Scurtături de tastatură: [ capitolul anterior · ] capitolul următor