Selektorer
Som standard søger Glaze efter elementer med attributten data-animate og opbygger animationen ud fra attributtens værdi. Denne side gennemgår de tre indstillinger, der ændrer, hvilke elementer Glaze læser, dataAttribute, className og element, samt de kantede parentes-selectors, der retter en animation mod andre elementer. Hjælpefunktionerne i strengen beskrives i Syntaks.
Sådan findes elementer
Når glaze() kører, og igen ved hver refresh() eller genopbygning i overvågningstilstand, gennemgår den alle elementer i roden og beholder dem, der har den konfigurerede attribut eller i klassetilstand en klasse med det konfigurerede præfiks. Selve rodelementet tæller også med, hvis det har attributten eller klassen. Elementer læses i dokumentrækkefølge.
Hvert element, der findes på denne måde, får sin egen tidslinje, medmindre det befinder sig inde i et tl-element eller linker til et med tl:<id>. I så fald føjes det til den tidslinje i stedet. Se Tidslinjer for at se, hvordan grupperingen fungerer.
Brugerdefineret attribut
Brug en anden dataattribut:
glaze({
lib: { gsap: { core: gsap } },
dataAttribute: "data-move",
})
Nu søger Glaze efter data-move i stedet for data-animate:
<div data-move="from:opacity-0"></div>
Indstillingen erstatter attributten i stedet for at tilføje en. Med indstillingen ovenfor ignoreres et element, der stadig har data-animate. Brug den, når et andet script på siden allerede læser data-animate, eller når du vil have markuppen til at navngive attributten efter dit projekt.
I tilstanden til overvågning overvåger Glaze den konfigurerede attribut, så en ændring af værdien af data-move på et element planlægger en genopbygning.
Klassestyret syntaks
Foretrækker du klasser frem for dataattributter? Aktivér klassetilstand:
glaze({
lib: { gsap: { core: gsap } },
className: "animate",
})
Nu kan du skrive animationer som klasser:
<div class="animate-from:opacity-0|duration-1"></div>
Dette fungerer godt, hvis du allerede bruger utility-first CSS og vil have dine animationer til at føles lignende. Klassetilstand er også nyttig, når et skabelonsystem lader dig tilføje klasser til et element, men ikke vilkårlige attributter.
Glaze læser alle klasser, der begynder med præfikset efterfulgt af en bindestreg (animate- her) og fjerner denne del. Klasser uden præfikset lades være, så animationsklasser kan stå ved siden af stylingklasser på samme element. Du kan fordele en animation på flere klasser:
<div class="card animate-from:opacity-0 animate-from:y-24"></div>
Responsive klasser accepterer breakpointet enten efter eller før præfikset. Begge disse køres kun, når lg breakpointet matcher:
<div class="animate-@lg:from:opacity-0"></div>
<div class="@lg:animate-from:opacity-0"></div>
Forudindstillinger fungerer på samme måde i klasser, for eksempel animate-preset-fadeIn.
Klassetilstand slår ikke dataattributten fra. Når et element har begge dele, føjer Glaze dem sammen til én streng: først attributværdien, derefter de præfiksbærende klasser i den rækkefølge, de står i attributten class.
<div
class="animate-from:opacity-0 animate-@lg:from:y-50"
data-animate="from:duration-1"
></div>
Dette element animeres fra opacity: 0 over ét sekund ved alle størrelser og også fra y: 50, når lg matcher. Da strengene sammenføjes, gælder den samme regel som i en enkelt streng: Når to dele angiver den samme egenskab, vinder den sidste. Her tilsidesætter klasseværdien attributværdien for x:
<div class="animate-to:x-100" data-animate="to:x-50|y-20"></div>
Elementet animeres til x: 100 og y: 20.
Når watch er aktiveret i klassetilstand, observerer Glaze også ændringer i class. Hvis du tilføjer en animate--klasse til et element eller ændrer klasserne på et element, som Glaze allerede læser eller animerer, planlægges en genopbygning. Inde i et element med en relativ selector gælder det samme for klasseændringer på dets efterkommere, da de kan ændre, hvad selectoren matcher. Klasseændringer på andre elementer registreres ikke, heller ikke på animerede elementers forældre. Derfor påvirker det ikke igangværende animationer, hvis du skifter en klasse for mørk tilstand på <html> eller en klasse, der låser rulning, på <body>. En klasseændring, der får et element til at matche en global selector, bliver heller ikke registreret; kald refresh() bagefter.
Begrænsning af søgningen
Glaze søger som standard i hele document. Angiv element for kun at animere elementer i en beholder:
glaze({
lib: { gsap: { core: gsap } },
element: document.querySelector("#app"),
})
element accepterer en Element eller en Document. Den begrænser tre ting:
- Kun roden og dens underordnede elementer gennemsøges for animationsværktøjer. Elementer andre steder på siden ignoreres, selv når de har
data-animate. - Overvågningstilstand holder kun øje med ændringer inde i roden.
destroy()rydder kun op efter det, denne instans har oprettet, så animationerne på resten af siden bevares.
Det gør element til det oplagte valg i komponentrammer. Opret én instans per monteret komponent med komponentens rodelement, og kald destroy(), når den afmonteres, som vist i Opdatering og oprydning. Giv separate instanser rødder, der ikke overlapper; et element inde i to rødder animeres af begge instanser.
Målretning af andre elementer
Indstillingerne ovenfor bestemmer, hvilke elementer Glaze læser. En selektor i kantede parenteser i begyndelsen af et segment bestemmer, hvilke elementer animationen anvendes på. Uden en sådan selektor målrettes animationen mod det element, der har værktøjerne.
Relative selektorer
En selektor, der begynder med &, fortolkes ud fra selve elementet, hvor & står for det element. Der forespørges med querySelectorAll, så selektoren kan matche flere elementer:
<ul data-animate="[&>li]:from:opacity-0|y-20|stagger-0.1">
<li>One</li>
<li>Two</li>
<li>Three</li>
</ul>
[&>li] matcher de direkte li underordnede elementer. Værdien stagger placerer deres starttidspunkter med 0.1 sekunders mellemrum. Brug dette, når ét element skal styre animationen af en liste, et gitter eller en gruppe underordnede elementer uden at tilføje en attribut til hvert enkelt.
Skriv mellemrum som understregninger. [&_p] bliver til & p og matcher alle p inde i elementet på alle dybder:
<article data-animate="[&_p]:from:opacity-0|stagger-0.2">
<p>First paragraph</p>
<div><p>Nested paragraph</p></div>
</article>
Hver understregning i en selektor bliver til et mellemrum, så et klassenavn med en understregning kan ikke matches på denne måde.
[&] fortolkes som selve elementet. Det bruges mest som en værdi, for eksempel scrollTrigger.trigger-[&] i ScrollTrigger og tidslinjestandardindstillinger.
Globale selektorer
En selektor uden & sendes som en streng til animationsmotoren. GSAP og Motion fortolker den i forhold til hele dokumentet, ikke i forhold til elementet eller roden element:
<h2 data-animate="[.badge]:from:opacity-0|scale-0.5|duration-0.3">Inbox</h2>
<span class="badge">3</span>
Dette animerer hvert .badge på siden, uanset hvor det befinder sig. Foretræk relative selektorer i genanvendelige komponenter, fordi en global selektor også matcher kopier af komponenten andre steder på siden.
Begrænsninger
Hvert element har ét mål. Når flere segmenter har en selektor, anvendes den sidste på alle elementets tilstande. Her anvendes både from og to på p, ikke på h1:
<div data-animate="[&>h1]:from:opacity-0 [&>p]:to:x-20">
<h1>Title</h1>
<p>Text</p>
</div>
Hvis to grupper skal animeres forskelligt, skal du placere værktøjerne på selve de underordnede elementer eller gruppere dem på en tidslinje.
En selektor slutter ved det første ], så selektorer med kantede parenteser, såsom attributselektorer som [&>[data-item]], understøttes ikke. Brug i stedet en klasse- eller elementselektor.
Selektorer kombineres med breakpoints i den rækkefølge, der beskrives i Syntaks, for eksempel @lg:[&>div]:from:opacity-0.