Ga naar de inhoud

Selectors

Standaard zoekt Glaze naar elementen met het attribuut data-animate en bouwt de animatie op basis van de waarde van dat attribuut. Op deze pagina worden de drie opties besproken die bepalen welke elementen Glaze leest: dataAttribute, className en element, plus de selectors tussen vierkante haken die een animatie op andere elementen richten. De hulpmiddelen in de tekenreeks worden beschreven in Syntaxis.

Hoe elementen worden gevonden

Wanneer glaze() wordt uitgevoerd, en opnieuw bij elke refresh() of heropbouw in de waakmodus, doorloopt het elk element binnen de root en behoudt het de elementen met het geconfigureerde attribuut of, in klassenmodus, een klasse met het geconfigureerde voorvoegsel. Ook het rootelement telt mee als het zo'n attribuut of klasse heeft. Elementen worden gelezen in documentvolgorde.

Elk element dat op deze manier wordt gevonden, krijgt een eigen tijdlijn, tenzij het zich binnen een element tl bevindt of ernaar verwijst met tl:<id>. In dat geval wordt het aan die tijdlijn toegevoegd. Zie Tijdlijnen voor meer informatie over de groepering.

Aangepast attribuut

Gebruik een ander data-attribuut:

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

Nu zoekt Glaze naar data-move in plaats van data-animate:

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

De optie vervangt het attribuut in plaats van er een toe te voegen. Met de bovenstaande instelling wordt een element dat nog steeds data-animate bevat genegeerd. Gebruik dit wanneer een ander script op de pagina data-animate al uitleest, of wanneer u wilt dat de markup het attribuut naar uw project noemt.

In de modus watch houdt Glaze het ingestelde attribuut in de gaten. Als de waarde van data-move op een element verandert, wordt er een nieuwe build ingepland.

Syntaxis op basis van klassen

Gebruik je liever klassen dan data-attributen? Schakel dan de klassenmodus in:

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

Nu kun je animaties als klassen schrijven:

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

Dit werkt goed als u al utility-first CSS gebruikt en wilt dat uw animaties er vergelijkbaar uitzien. De klassenmodus is ook handig wanneer u in een templatesysteem wel klassen aan een element kunt toevoegen, maar geen willekeurige attributen.

Glaze leest elke klasse die begint met het voorvoegsel gevolgd door een koppelteken (hier animate-) en verwijdert dat deel. Klassen zonder het voorvoegsel blijven ongewijzigd, zodat animatieklassen naast stijlklassen op hetzelfde element kunnen staan. U kunt een animatie over meerdere klassen verdelen:

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

Responsieve classes accepteren het breekpunt zowel na als vóór het voorvoegsel. Beide worden alleen uitgevoerd wanneer het lg breekpunt overeenkomt:

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

Voorinstellingen werken op dezelfde manier in klassen, bijvoorbeeld animate-preset-fadeIn.

De klassenmodus schakelt het data-attribuut niet uit. Als een element beide heeft, voegt Glaze ze samen tot één tekenreeks: eerst de attribuutwaarde, daarna de klassen met het voorvoegsel in de volgorde waarin ze in het attribuut class staan.

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

Dit element animeert vanaf opacity: 0 gedurende één seconde op elk formaat, en ook vanaf y: 50 wanneer lg overeenkomt. Omdat de tekenreeksen worden samengevoegd, geldt dezelfde regel als binnen één tekenreeks: als twee delen dezelfde eigenschap instellen, heeft het latere deel voorrang. Hier overschrijft de klassewaarde de attribuutwaarde voor x:

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

Het element animeert naar x: 100 en y: 20.

Als watch is ingeschakeld in de classmodus, houdt Glaze ook wijzigingen in class bij. Als je een animate--class aan een element toevoegt, of de classes wijzigt van een element dat Glaze al uitleest of animeert, wordt er een nieuwe opbouw gepland. Binnen een element met een relatieve selector leiden classwijzigingen bij afstammelingen ook tot een nieuwe opbouw, omdat ze kunnen veranderen waarop de selector matcht. Classwijzigingen bij andere elementen doen dat niet. Dat geldt ook voor voorouders van geanimeerde elementen, dus als je een darkmode-class toevoegt aan <html> of een scroll-lock-class aan <body>, blijven actieve animaties ongewijzigd. Een classwijziging waardoor een element nieuw aan een globale selector voldoet, wordt ook niet opgemerkt; roep daarna refresh() aan.

Glaze doorzoekt standaard de hele document. Geef element mee om alleen elementen binnen een container te animeren:

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

element accepteert een Element of een Document. Het beperkt drie dingen:

  • Alleen de hoofdnode en de onderliggende elementen worden doorzocht op animatiehulpmiddelen. Elementen elders op de pagina worden genegeerd, ook als ze data-animate bevatten.
  • De watchmodus houdt alleen wijzigingen binnen de hoofdnode in de gaten.
  • destroy() ruimt alleen op wat deze instantie heeft aangemaakt, zodat animaties van andere onderdelen van de pagina behouden blijven.

Daardoor is element de aangewezen optie voor componentframeworks. Maak voor elke gemonteerde component een instantie met het root-element van de component en roep destroy() aan wanneer deze wordt verwijderd, zoals getoond in Vernieuwen en opruimen. Geef afzonderlijke instanties root-elementen die elkaar niet overlappen; een element binnen twee roots wordt door beide instanties geanimeerd.

Andere elementen targeten

De bovenstaande opties bepalen welke elementen Glaze uitleest. Een selector tussen vierkante haken aan het begin van een segment bepaalt op welke elementen de animatie wordt toegepast. Zonder selector is het doel van de animatie het element met de hulpmiddelen.

Relatieve selectors

Een selector die begint met & wordt vanaf het element zelf opgelost, waarbij & dat element aanduidt. De selector wordt bevraagd met querySelectorAll en kan daardoor meerdere elementen vinden:

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

[&>li] komt overeen met de directe li-kinderen. De waarde stagger spreidt hun starttijden met 0,1 seconde tussenruimte. Gebruik dit wanneer één element de animatie van een lijst, raster of groep kinderen moet aansturen zonder aan elk kind een attribuut toe te voegen.

Schrijf spaties als underscores. [&_p] wordt & p en komt overeen met alle p binnen het element, op elke diepte:

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

Elke underscore in een selector wordt omgezet in een spatie, dus een klassenaam met een underscore kan op deze manier niet worden gevonden.

[&] op zichzelf verwijst naar het element zelf. Het wordt vooral als waarde gebruikt, bijvoorbeeld scrollTrigger.trigger-[&] in ScrollTrigger en de standaardwaarden voor de tijdlijn in standaardwaarden.

Globale selectors

Een selector zonder & wordt als tekenreeks doorgegeven aan de animatie-engine. GSAP en Motion zoeken deze in het hele document, niet binnen het element of de root element:

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

Hiermee wordt elke .badge op de pagina geanimeerd, waar deze zich ook bevindt. Gebruik bij herbruikbare componenten bij voorkeur relatieve selectors, omdat een globale selector ook exemplaren van de component elders op de pagina vindt.

Beperkingen

Elk element heeft één doel. Als meerdere segmenten een selector bevatten, geldt de laatste voor alle toestanden van het element. Hier worden zowel from als to toegepast op de p, niet op de h1:

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

Als u twee groepen verschillend wilt animeren, plaatst u de hulpmiddelen op de kinderen zelf of groepeert u ze in een tijdlijn.

Een selector eindigt bij de eerste ]. Selectors met vierkante haken, zoals attribuutselectors als [&>[data-item]], worden daarom niet ondersteund. Gebruik in plaats daarvan een klasse- of elementselector.

Selectors worden gecombineerd met breekpunten in de volgorde die wordt beschreven in Syntaxis, bijvoorbeeld @lg:[&>div]:from:opacity-0.