Väljare
Som standard söker Glaze efter element med attributet data-animate och bygger animationen utifrån attributets värde. Den här sidan beskriver de tre alternativen som ändrar vilka element Glaze läser: dataAttribute, className och element, samt hakparentesväljare som riktar en animation mot andra element. Verktygen i strängen beskrivs i Syntax.
Så hittas element
När glaze() körs, och återigen vid varje refresh() eller ombyggnad i bevakningsläge, går det igenom alla element i roten och behåller dem som har det konfigurerade attributet eller, i klassläge, en klass med det konfigurerade prefixet. Även rotelementet räknas om det har ett sådant. Elementen läses i dokumentordning.
Varje element som hittas på det här sättet får en egen tidslinje, såvida det inte ligger inuti ett tl-element eller länkar till ett med tl:<id>. I så fall läggs det till i den tidslinjen i stället. Se Tidslinjer för information om hur grupperingen fungerar.
Anpassat attribut
Använd ett annat dataattribut:
glaze({
lib: { gsap: { core: gsap } },
dataAttribute: "data-move",
})
Nu letar Glaze efter data-move i stället för data-animate:
<div data-move="from:opacity-0"></div>
Alternativet ersätter attributet i stället för att lägga till ett. Med inställningen ovan ignoreras ett element som fortfarande har data-animate. Använd det när ett annat skript på sidan redan läser data-animate eller när du vill att markuppen ska ange attributet efter ditt projekt.
I bevakningsläget observerar Glaze det konfigurerade attributet, så när värdet på data-move ändras för ett element schemaläggs en ombyggnad.
Klassbaserad syntax
Föredrar du klasser framför dataattribut? Aktivera klassläget:
glaze({
lib: { gsap: { core: gsap } },
className: "animate",
})
Nu kan du skriva animationer som klasser:
<div class="animate-from:opacity-0|duration-1"></div>
Det här fungerar bra om du redan använder utility-first CSS och vill att dina animationer ska kännas liknande. Klassläget är också användbart när ett mallsystem låter dig lägga till klasser på ett element men inte godtyckliga attribut.
Glaze läser varje klass som börjar med prefixet följt av ett bindestreck (animate- här) och tar bort den delen. Klasser utan prefixet lämnas orörda, så animationsklasser kan ligga bredvid stilklasser på samma element. Du kan dela upp en animation över flera klasser:
<div class="card animate-from:opacity-0 animate-from:y-24"></div>
Responsiva klasser accepterar brytpunkten antingen efter eller före prefixet. Båda dessa körs endast när lg brytpunkten matchar:
<div class="animate-@lg:from:opacity-0"></div>
<div class="@lg:animate-from:opacity-0"></div>
Förinställningar fungerar på samma sätt i klasser, till exempel animate-preset-fadeIn.
Klassläget stänger inte av dataattributet. När ett element har båda sammanfogar Glaze dem till en sträng: först attributvärdet och sedan de prefixförsedda klasserna i den ordning de förekommer i attributet class.
<div
class="animate-from:opacity-0 animate-@lg:from:y-50"
data-animate="from:duration-1"
></div>
Det här elementet animeras från opacity: 0 under en sekund i alla storlekar, och även från y: 50 när lg matchar. Eftersom strängarna sammanfogas gäller samma regel som inom en enda sträng: när två delar anger samma egenskap vinner den senare. Här åsidosätter klassvärdet attributvärdet för x:
<div class="animate-to:x-100" data-animate="to:x-50|y-20"></div>
Elementet animeras till x: 100 och y: 20.
När watch är aktiverat i klassläge observerar Glaze även ändringar i class. Om du lägger till en animate--klass på ett element, eller ändrar klasserna på ett element som Glaze redan läser av eller animerar, schemaläggs en ombyggnad. Inuti ett element med en relativ väljare gör även klassändringar på dess underordnade element det, eftersom de kan påverka vad väljaren matchar. Klassändringar på andra element gör det inte, och det gäller även överordnade element till animerade element. Därför påverkar det inte pågående animeringar om du växlar en klass för mörkt läge på <html> eller en klass för att låsa rullning på <body>. En klassändring som gör att ett element börjar matcha en global väljare upptäcks inte heller. Anropa refresh() efteråt.
Begränsa sökningen
Glaze söker som standard igenom hela document. Skicka element för att endast animera element inuti en behållare:
glaze({
lib: { gsap: { core: gsap } },
element: document.querySelector("#app"),
})
element accepterar en Element eller en Document. Det begränsar tre saker:
- Endast roten och dess underordnade element genomsöks efter animationsverktyg. Element på andra ställen på sidan ignoreras, även om de har
data-animate. - Bevakningsläget observerar endast ändringar inuti roten.
destroy()städar endast upp det som den här instansen har skapat, så andra delar av sidan behåller sina animationer.
Det gör element till det naturliga valet i komponentramverk. Skapa en instans per monterad komponent med komponentens rotelement och anropa destroy() när den avmonteras, som visas i Uppdatering och städning. Ge separata instanser rötter som inte överlappar; ett element inuti två rötter animeras av båda instanserna.
Rikta in andra element
Alternativen ovan avgör vilka element Glaze läser. En hakparentesväljare i början av ett segment avgör vilka element animationen tillämpas på. Utan en sådan riktas animationen mot elementet som har verktygsklasserna.
Relativa väljare
En väljare som börjar med & löses utifrån själva elementet, där & står för det elementet. Den söks med querySelectorAll, så den kan matcha flera element:
<ul data-animate="[&>li]:from:opacity-0|y-20|stagger-0.1">
<li>One</li>
<li>Two</li>
<li>Three</li>
</ul>
[&>li] matchar de direkta li-barnen. Värdet stagger placerar deras starttider med 0.1 sekunders mellanrum. Använd detta när ett element ska styra animeringen av en lista, ett rutnät eller en grupp underordnade element utan att lägga till ett attribut på varje barn.
Skriv mellanslag som understreck. [&_p] blir & p och matchar varje p inuti elementet, oavsett djup:
<article data-animate="[&_p]:from:opacity-0|stagger-0.2">
<p>First paragraph</p>
<div><p>Nested paragraph</p></div>
</article>
Varje understreck i en väljare omvandlas till ett mellanslag, så ett klassnamn som innehåller ett understreck kan inte matchas på det här sättet.
[&] löser på egen hand ut till själva elementet. Det används oftast som ett värde, till exempel scrollTrigger.trigger-[&] i ScrollTrigger och tidslinjens standardvärden.
Globala väljare
En väljare utan & skickas som en sträng till animationsmotorn. GSAP och Motion löser båda upp den mot hela dokumentet, inte mot elementet eller roten element:
<h2 data-animate="[.badge]:from:opacity-0|scale-0.5|duration-0.3">Inbox</h2>
<span class="badge">3</span>
Det här animerar varje .badge på sidan, oavsett var det finns. Föredra relativa väljare i återanvändbara komponenter, eftersom en global väljare även matchar kopior av komponenten på andra ställen på sidan.
Begränsningar
Varje element har ett mål. När flera segment innehåller en väljare tillämpas den sista på alla elementets tillstånd. Här tillämpas både from och to på p, inte h1:
<div data-animate="[&>h1]:from:opacity-0 [&>p]:to:x-20">
<h1>Title</h1>
<p>Text</p>
</div>
Om två grupper ska animeras på olika sätt placerar du verktygsklasserna direkt på barnen eller grupperar dem i en tidslinje.
En väljare avslutas vid det första ], så väljare som innehåller hakparenteser, som attributväljare som [&>[data-item]], stöds inte. Använd i stället en klass- eller elementväljare.
Väljare kombineras med brytpunkter i den ordning som beskrivs i Syntax, till exempel @lg:[&>div]:from:opacity-0.