Skill'in Kendi İfadeleriyle
gsap-core, GSAP'in çekirdek motoru için giriş skill'idir: gsap.to(), gsap.from(), gsap.fromTo() ve gsap.set() ile tekli tween'ler, ayrıca yaygın değişkenler — duration (varsayılan 0.5), delay, ease (varsayılan power1.out), stagger, overwrite ve immediateRender. GSAP'in dönüşüm takma adlarını (x, y, scale, rotation, xPercent), solmalar için autoAlpha'yı, clearProps'u, fonksiyon tabanlı ve bağıl değerleri, proje genelindeki gsap.defaults()'u belgeler.
Büyük bir bölüm, duyarlı kırılma noktaları ve prefers-reduced-motion için gsap.matchMedia()'yı ele alır ve resmi en iyi uygulamalar listesi ile bir Yapmayın bölümüyle kapanır. React, Vue, Svelte veya vanilla JS'de GSAP animasyonu yazan veya inceleyen tasarımcılar ve geliştiriciler için yazılmıştır.
Neler üretir
- Çekirdek motorun içinde gelen ve ek bir plugin gerektirmeyen CSSPlugin aracılığıyla animasyonlu DOM elemanları.
- Her tween yönteminin döndürdüğü ve duraklatma, oynatma, tersine çevirme, sonlandırma veya scrub işlemi gerektiğinde sakladığınız bir Tween örneği.
- Alias olarak yazılan ve sabit bir sırada uygulanan dönüşümler: translation, scale, rotationX/Y, skew, rotation.
- Bir matchMedia handler içinde oluşturulan ve sorgu eşleşmeyi bıraktığında otomatik olarak geri alınan animasyonlar ve ScrollTrigger'lar.
Nasıl Çalışır
- 01Tween Yöntemini Seçin
gsap.to() mevcut durumdan geçtiğiniz vars değerlerine doğru animasyon yapar ve en yaygın çağrıdır; from() bunu giriş animasyonları için tersine çevirir, fromTo() mevcut değerleri okumadan her iki uçu açıkça belirtir ve set() süre 0 ile anında uygulanır.
- 02Vars'ı camelCase Yazın
vars nesnesi içindeki özellik adları camelCase olmalıdır; bu nedenle background-color veya font-size gibi CSS özellikleri backgroundColor ve fontSize haline gelir.
- 03Stagger ile Offset Uygulayın
stagger üzerindeki düz bir sayı, her hedef arasındaki saniye farkıdır; nesne biçimi ise from yönü ile amount veya from: "random" ile each gibi seçenekler ekler.
- 04Bir Ease Seçin
String ease'ler çoğu durumu kapsar — power1.out varsayılan hissi verir, dokümante edilmiş alternatifler ise back.out(1.7), elastic.out(1, 0.3), power3.inOut ve none'dır.
- 05Değerleri Hedef Başına Hesaplayın
vars değeri olarak geçirilen bir fonksiyon, ilk render'da her hedef için bir kez çağrılır; bu sayede x: (i) => i * 50 gibi indeks tabanlı değerler bir set üzerinde dağıtılabilir.
- 06Çalışmayı Medya Sorgularına Sınırlayın
gsap.matchMedia() kurulum handler'ını yalnızca sorgu eşleştiği sürece çalıştırır; skill'in duyarlı kırılma noktalarını ve reduced-motion kullanıcılarını ele alma yöntemi budur.