Pemilih
Secara default, Glaze mencari elemen dengan atribut data-animate dan membangun animasi berdasarkan nilai atribut tersebut. Halaman ini membahas tiga opsi yang mengubah elemen yang dibaca oleh Glaze, dataAttribute, className, dan element, serta selector kurung siku yang mengarahkan animasi ke elemen lain. Utilitas di dalam string dijelaskan dalam Sintaks.
Cara elemen ditemukan
Saat glaze() dijalankan, dan sekali lagi pada setiap refresh() atau pembangunan ulang mode pemantauan, sistem menelusuri setiap elemen di dalam root dan memilih elemen yang memiliki atribut yang dikonfigurasi atau, dalam mode kelas, kelas dengan prefiks yang dikonfigurasi. Elemen root juga dihitung jika memiliki salah satunya. Elemen dibaca sesuai urutan dokumen.
Setiap elemen yang ditemukan dengan cara ini mendapatkan timeline sendiri, kecuali jika berada di dalam elemen tl atau ditautkan ke elemen tersebut dengan tl:<id>. Dalam hal itu, elemen ditambahkan ke timeline tersebut. Lihat Timeline untuk memahami cara kerja pengelompokan.
Atribut khusus
Gunakan atribut data yang berbeda:
glaze({
lib: { gsap: { core: gsap } },
dataAttribute: "data-move",
})
Sekarang Glaze akan mencari data-move sebagai pengganti data-animate:
<div data-move="from:opacity-0"></div>
Opsi ini mengganti atribut, bukan menambahkan atribut. Dengan pengaturan di atas, elemen yang masih memiliki data-animate akan diabaikan. Gunakan opsi ini jika skrip lain di halaman sudah membaca data-animate, atau jika Anda ingin markup menggunakan nama atribut sesuai proyek Anda.
Dalam mode pantau, Glaze mengamati atribut yang dikonfigurasi, sehingga perubahan nilai data-move pada elemen akan menjadwalkan pembangunan ulang.
Sintaks berbasis kelas
Lebih suka menggunakan kelas daripada atribut data? Aktifkan mode kelas:
glaze({
lib: { gsap: { core: gsap } },
className: "animate",
})
Sekarang Anda dapat menulis animasi sebagai kelas:
<div class="animate-from:opacity-0|duration-1"></div>
Cara ini cocok jika Anda sudah menggunakan CSS berbasis utilitas dan ingin animasi Anda terasa serupa. Mode kelas juga berguna jika sistem templat memungkinkan Anda menambahkan kelas ke elemen, tetapi tidak memungkinkan penambahan atribut sembarang.
Glaze membaca setiap kelas yang diawali prefiks diikuti tanda hubung (animate- di sini), lalu menghapus bagian tersebut. Kelas tanpa prefiks dibiarkan, sehingga kelas animasi dapat berdampingan dengan kelas gaya pada elemen yang sama. Anda dapat membagi animasi ke beberapa kelas:
<div class="card animate-from:opacity-0 animate-from:y-24"></div>
Kelas responsif menerima breakpoint setelah atau sebelum prefiks.
Keduanya hanya berjalan saat lg breakpoint cocok:
<div class="animate-@lg:from:opacity-0"></div>
<div class="@lg:animate-from:opacity-0"></div>
Prasetel berfungsi sama pada kelas, misalnya animate-preset-fadeIn.
Mode kelas tidak menonaktifkan atribut data. Jika elemen memiliki keduanya, Glaze menggabungkannya menjadi satu string: nilai atribut terlebih dahulu, lalu kelas berprefiks sesuai urutannya dalam atribut class.
<div
class="animate-from:opacity-0 animate-@lg:from:y-50"
data-animate="from:duration-1"
></div>
Elemen ini beranimasi dari opacity: 0 selama satu detik pada semua ukuran, dan juga dari y: 50 saat lg cocok. Karena string digabungkan, aturan yang sama berlaku seperti dalam satu string: jika dua bagian menetapkan properti yang sama, bagian yang muncul belakangan akan menang. Di sini, nilai kelas menimpa nilai atribut untuk x:
<div class="animate-to:x-100" data-animate="to:x-50|y-20"></div>
Elemen beranimasi ke x: 100 dan y: 20.
Dengan watch diaktifkan dalam mode class, Glaze juga mengamati perubahan class. Menambahkan class animate- ke elemen, atau mengubah class elemen yang Glaze sudah dibaca atau dianimasikan, akan menjadwalkan pembangunan ulang. Di dalam elemen dengan selektor relatif, perubahan class pada turunannya juga menjadwalkan pembangunan ulang karena dapat mengubah kecocokan selektor. Perubahan class pada elemen lain tidak menjadwalkan pembangunan ulang, termasuk pada leluhur elemen yang dianimasikan, sehingga mengaktifkan atau menonaktifkan class mode gelap pada <html> atau class pengunci gulir pada <body> tidak mengganggu animasi yang sedang berjalan. Perubahan class yang membuat elemen baru cocok dengan selektor global juga tidak terdeteksi; panggil refresh() setelahnya.
Membatasi pencarian
Glaze secara default mencari di seluruh document. Berikan element agar hanya elemen di dalam wadah yang dianimasikan:
glaze({
lib: { gsap: { core: gsap } },
element: document.querySelector("#app"),
})
element menerima Element atau Document. Opsi ini membatasi tiga hal:
- Hanya akar dan turunannya yang dipindai untuk utilitas animasi. Elemen di bagian lain halaman diabaikan, meskipun memiliki
data-animate. - Mode pantau hanya mengamati mutasi di dalam akar.
destroy()hanya membersihkan hal-hal yang dibuat oleh instans ini, sehingga bagian lain halaman tetap mempertahankan animasinya.
Dengan demikian, element menjadi opsi yang tepat untuk kerangka kerja komponen. Buat satu instans untuk setiap komponen yang dipasang dengan elemen akar komponen tersebut, lalu panggil destroy() saat komponen dilepas, seperti ditunjukkan dalam Penyegaran dan pembersihan. Berikan akar yang tidak saling tumpang tindih kepada setiap instans; elemen di dalam dua akar akan dianimasikan oleh kedua instans.
Menargetkan elemen lain
Opsi di atas menentukan elemen yang dibaca Glaze. Pemilih dalam tanda kurung siku di awal segmen menentukan elemen yang dikenai animasi. Tanpa pemilih, animasi menargetkan elemen yang memuat utilitas tersebut.
Pemilih relatif
Pemilih yang diawali & ditentukan dari elemen itu sendiri, dengan & mewakili elemen tersebut. Pemilih ini dicari menggunakan querySelectorAll, sehingga dapat mencocokkan beberapa elemen:
<ul data-animate="[&>li]:from:opacity-0|y-20|stagger-0.1">
<li>One</li>
<li>Two</li>
<li>Three</li>
</ul>
[&>li] mencocokkan elemen anak langsung li. Nilai stagger memberi jarak 0.1 detik pada waktu mulai masing-masing. Gunakan ini ketika satu elemen perlu mengendalikan animasi daftar, kisi, atau kelompok elemen anak tanpa menambahkan atribut ke setiap elemen anak.
Tuliskan spasi sebagai garis bawah. [&_p] menjadi & p dan mencocokkan setiap p di dalam elemen pada kedalaman apa pun:
<article data-animate="[&_p]:from:opacity-0|stagger-0.2">
<p>First paragraph</p>
<div><p>Nested paragraph</p></div>
</article>
Setiap garis bawah dalam pemilih diubah menjadi spasi, sehingga nama kelas yang berisi garis bawah tidak dapat dicocokkan dengan cara ini.
[&] jika berdiri sendiri merujuk ke elemen itu sendiri. Ini biasanya digunakan sebagai nilai,
misalnya scrollTrigger.trigger-[&] dalam ScrollTrigger
dan nilai default pada timeline.
Pemilih global
Pemilih tanpa & diteruskan ke mesin animasi sebagai string. GSAP dan Motion sama-sama mencarinya di seluruh dokumen, bukan pada elemen atau akar element:
<h2 data-animate="[.badge]:from:opacity-0|scale-0.5|duration-0.3">Inbox</h2>
<span class="badge">3</span>
Ini menganimasikan setiap .badge di halaman, di mana pun letaknya. Utamakan pemilih relatif di dalam komponen yang dapat digunakan kembali, karena pemilih global juga mencocokkan salinan komponen di bagian lain halaman.
Batasan
Setiap elemen memiliki satu target. Jika beberapa segmen memuat pemilih, segmen terakhir berlaku untuk semua status elemen. Di sini, from dan to sama-sama diterapkan ke p, bukan ke h1:
<div data-animate="[&>h1]:from:opacity-0 [&>p]:to:x-20">
<h1>Title</h1>
<p>Text</p>
</div>
Untuk menganimasikan dua kelompok secara berbeda, pasang utilitas pada elemen anak itu sendiri, atau kelompokkan elemen tersebut dalam linimasa.
Pemilih berakhir pada ] pertama, sehingga pemilih yang berisi tanda kurung siku, seperti pemilih atribut [&>[data-item]], tidak didukung. Gunakan pemilih kelas atau elemen.
Pemilih digabungkan dengan titik henti sesuai urutan yang dijelaskan dalam Sintaks, misalnya @lg:[&>div]:from:opacity-0.