İçeriğe geç

Seçiciler

Varsayılan olarak Glaze, data-animate özniteliğine sahip öğeleri arar ve animasyonu bu özniteliğin değerine göre oluşturur. Bu sayfada Glaze öğesinin hangi öğeleri okuyacağını değiştiren üç seçenek (dataAttribute, className ve element) ile animasyonu başka öğelere yönlendiren köşeli ayraç seçicileri ele alınır. Dizenin içindeki yardımcılar Söz Dizimi bölümünde açıklanır.

Öğeler nasıl bulunur

glaze() çalıştığında ve her refresh() ya da izleme modu yeniden oluşturmasında, kök içindeki tüm öğeleri tarar ve yapılandırılmış özniteliği taşıyanları veya sınıf modunda yapılandırılmış öneke sahip bir sınıfı bulunanları seçer. Kök öğe de bu özniteliği taşıyorsa sayılır. Öğeler belge sırasına göre okunur.

Bu şekilde bulunan her öğe, bir tl öğesinin içinde değilse veya tl:<id> ile ona bağlanmıyorsa kendi zaman çizelgesini alır. Bu durumda onun yerine o zaman çizelgesine eklenir. Gruplandırmanın nasıl çalıştığı için Zaman Çizelgeleri bölümüne bakın.

Özel öznitelik

Farklı bir veri özniteliği kullanın:

JavaScript
glaze({
  lib: { gsap: { core: gsap } },
  dataAttribute: "data-move",
})

Artık Glaze, data-animate yerine data-move öğesini arayacak:

HTML
<div data-move="from:opacity-0"></div>

Bu seçenek, bir öznitelik eklemek yerine mevcut özniteliğin yerini alır. Yukarıdaki ayarla, hâlâ data-animate taşıyan bir öğe yok sayılır. Sayfadaki başka bir betik zaten data-animate değerini okuyorsa veya işaretlemede öznitelik adının projenize göre belirlenmesini istiyorsanız bunu kullanın.

izleme modunda, Glaze yapılandırılmış özniteliği izler; bu nedenle bir öğedeki data-move değerinin değiştirilmesi yeniden derleme zamanlar.

Sınıf tabanlı söz dizimi

Veri öznitelikleri yerine sınıfları mı tercih ediyorsunuz? Sınıf modunu etkinleştirin:

JavaScript
glaze({
  lib: { gsap: { core: gsap } },
  className: "animate",
})

Artık animasyonları sınıf olarak yazabilirsiniz:

HTML
<div class="animate-from:opacity-0|duration-1"></div>

Yardımcı sınıf odaklı CSS kullanıyorsanız ve animasyonlarınızın benzer hissettirmesini istiyorsanız bu iyi sonuç verir. Şablon sisteminin bir öğeye sınıf eklemenize izin verip rastgele öznitelik eklemenize izin vermediği durumlarda da sınıf modu kullanışlıdır.

Glaze, önekten sonra kısa çizgi gelen önekle başlayan tüm sınıfları (buradaki animate- gibi) okur ve bu kısmı kaldırır. Öneki olmayan sınıflar olduğu gibi kalır; böylece animasyon sınıfları aynı öğedeki stil sınıflarının yanında bulunabilir. Bir animasyonu birkaç sınıfa bölebilirsiniz:

HTML
<div class="card animate-from:opacity-0 animate-from:y-24"></div>

Duyarlı sınıflarda kesme noktasını önekten sonra da önce de kullanabilirsiniz. Her ikisi de yalnızca lg kesme noktası eşleştiğinde çalışır:

HTML
<div class="animate-@lg:from:opacity-0"></div>
<div class="@lg:animate-from:opacity-0"></div>

Önayarlar sınıflarda da aynı şekilde çalışır; örneğin animate-preset-fadeIn.

Sınıf modu, veri özniteliğini devre dışı bırakmaz. Bir öğede ikisi de varsa Glaze bunları tek bir dizgede birleştirir: önce öznitelik değeri, ardından class özniteliğinde göründükleri sırayla önekli sınıflar.

HTML
<div
  class="animate-from:opacity-0 animate-@lg:from:y-50"
  data-animate="from:duration-1"
></div>

Bu öğe her boyutta bir saniye boyunca opacity: 0 durumundan animasyonla geçer; ayrıca lg eşleştiğinde y: 50 durumundan da geçer. Dizgeler birleştirildiğinden, tek bir dizgede olduğu gibi aynı kural geçerlidir: iki kısım aynı özelliği ayarlarsa sonraki kazanır. Burada sınıf değeri, x için öznitelik değerini geçersiz kılar:

HTML
<div class="animate-to:x-100" data-animate="to:x-50|y-20"></div>

Öğe, x: 100 ve y: 20 durumlarına animasyonla geçer.

Sınıf modunda watch etkinleştirildiğinde, Glaze class değişikliklerini de izler. Bir öğeye animate- sınıfı eklemek veya Glaze zaten okuduğu ya da animasyon uyguladığı bir öğenin sınıflarını değiştirmek yeniden oluşturma işlemini planlar. Göreli seçici içeren bir öğenin alt öğelerindeki sınıf değişiklikleri de yeniden oluşturma işlemini planlar; çünkü bu değişiklikler seçicinin eşleştiği öğeleri değiştirebilir. Diğer öğelerdeki sınıf değişiklikleri bunu yapmaz; animasyon uygulanan öğelerin üst öğeleri de buna dahildir. Bu nedenle <html> üzerinde koyu mod sınıfını veya <body> üzerinde kaydırma kilidi sınıfını değiştirmek çalışan animasyonları etkilemez. Bir öğenin artık genel bir seçiciyle eşleşmesine yol açan sınıf değişikliği de algılanmaz; değişikliğin ardından refresh() çağrısını yapın.

Glaze varsayılan olarak tüm document içinde arama yapar. Yalnızca bir kapsayıcının içindeki öğelere animasyon uygulamak için element iletin:

JavaScript
glaze({
  lib: { gsap: { core: gsap } },
  element: document.querySelector("#app"),
})

element bir Element veya Document kabul eder. Üç şeyi sınırlar:

  • Animasyon yardımcı sınıfları için yalnızca kök ve alt öğeleri taranır. Sayfanın başka yerlerindeki öğeler, data-animate taşısalar bile yok sayılır.
  • İzleme modu yalnızca kökün içindeki değişiklikleri izler.
  • destroy() yalnızca bu örneğin oluşturduklarını temizler; böylece sayfanın diğer bölümlerindeki animasyonlar korunur.

Bu nedenle element, bileşen çatılarında başvurulacak seçenektir. Bağlanan her bileşen için bileşenin kök öğesiyle bir örnek oluşturun ve bağlantısı kaldırıldığında destroy() çağırın; örnek için Yenileme ve temizleme bölümüne bakın. Örneklerin kökleri çakışmayacak şekilde ayarlayın; iki kökün içindeki bir öğeye her iki örnek de animasyon uygular.

Diğer öğeleri hedefleme

Yukarıdaki seçenekler, Glaze öğesinin hangi öğeleri okuyacağını belirler. Bir parçanın başındaki köşeli parantezli seçici, animasyonun hangi öğelere uygulanacağını belirler. Böyle bir seçici yoksa animasyon, yardımcı sınıfları taşıyan öğeyi hedefler.

Göreli seçiciler

& ile başlayan bir seçici, öğenin kendisine göre çözümlenir; & o öğeyi belirtir. Seçici querySelectorAll ile sorgulanır, bu nedenle birden fazla öğeyle eşleşebilir:

HTML
<ul data-animate="[&>li]:from:opacity-0|y-20|stagger-0.1">
  <li>One</li>
  <li>Two</li>
  <li>Three</li>
</ul>

[&>li] doğrudan li alt öğeleriyle eşleşir. stagger değeri, başlangıç zamanlarını 0.1 saniye aralıklarla düzenler. Her alt öğeye öznitelik eklemeden bir öğenin liste, ızgara veya alt öğe grubunun animasyonunu denetlemesini istediğinizde bunu kullanın.

Boşlukları alt çizgiyle yazın. [&_p], & p olur ve öğenin içindeki her derinlikteki tüm p öğeleriyle eşleşir:

HTML
<article data-animate="[&_p]:from:opacity-0|stagger-0.2">
  <p>First paragraph</p>
  <div><p>Nested paragraph</p></div>
</article>

Bir seçicideki her alt çizgi boşluğa dönüştürülür; bu nedenle alt çizgi içeren bir sınıf adı bu yöntemle eşleştirilemez.

Tek başına kullanıldığında [&] öğenin kendisine çözümlenir. Çoğunlukla bir değer olarak kullanılır; örneğin scrollTrigger.trigger-[&], ScrollTrigger ve zaman çizelgesi varsayılanları içinde.

Genel seçiciler

& içermeyen bir seçici, animasyon motoruna dizge olarak iletilir. GSAP ve Motion, seçiciyi öğeye veya element köküne göre değil, tüm belgeye göre çözümler:

HTML
<h2 data-animate="[.badge]:from:opacity-0|scale-0.5|duration-0.3">Inbox</h2>
<span class="badge">3</span>

Bu, sayfanın neresinde olursa olsun tüm .badge öğelerine animasyon uygular. Yeniden kullanılabilir bileşenlerde göreli seçicileri tercih edin; genel bir seçici, sayfanın başka yerlerindeki bileşen kopyalarıyla da eşleşir.

Sınırlamalar

Her öğenin tek bir hedefi vardır. Birden fazla parçada seçici varsa sonuncusu öğenin tüm durumlarına uygulanır. Burada hem from hem de to p öğesine uygulanır; h1 öğesine uygulanmaz:

HTML
<div data-animate="[&>h1]:from:opacity-0 [&>p]:to:x-20">
  <h1>Title</h1>
  <p>Text</p>
</div>

İki gruba farklı animasyonlar uygulamak için yardımcı sınıfları doğrudan alt öğelere ekleyin veya bunları bir zaman çizelgesinde gruplayın.

Seçici, ilk ] noktasında sona erer; bu nedenle öznitelik seçicileri gibi [&>[data-item]] örneğindeki köşeli parantezleri içeren seçiciler desteklenmez. Bunun yerine bir sınıf veya öğe seçicisi kullanın.

Seçiciler, Sözdizimi bölümünde açıklanan sırayla kesme noktalarıyla birleştirilir; örneğin @lg:[&>div]:from:opacity-0.