Přejít k obsahu

Výběrové řetězce

Ve výchozím nastavení Glaze vyhledá prvky s atributem data-animate a vytvoří animaci podle hodnoty tohoto atributu. Tato stránka popisuje tři možnosti, které určují, které prvky Glaze čte: dataAttribute, className a element, a selektory v hranatých závorkách, které nasměrují animaci na jiné prvky. Nástroje uvnitř řetězce jsou popsány v části Syntaxe.

Jak se vyhledávají prvky

Při spuštění glaze() a znovu při každém refresh() nebo opětovném sestavení v režimu sledování projde všechny prvky uvnitř kořenového prvku a ponechá ty, které mají nakonfigurovaný atribut, nebo v režimu tříd třídu s nakonfigurovanou předponou. Počítá se i samotný kořenový prvek, pokud daný atribut nebo třídu má. Prvky se načítají v pořadí dokumentu.

Každý takto nalezený prvek dostane vlastní časovou osu, pokud se nenachází uvnitř prvku tl nebo na něj neodkazuje pomocí tl:<id>. V takovém případě se místo toho přidá do této časové osy. V části Časové osy najdete informace o seskupování.

Vlastní atribut

Použijte jiný datový atribut:

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

Nyní bude Glaze hledat data-move místo data-animate:

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

Tato možnost atribut nahradí, místo aby přidala další. Při výše uvedeném nastavení se prvek, který stále obsahuje data-animate, ignoruje. Použijte ji, když jiný skript na stránce už čte data-animate nebo když chcete, aby označení atributu v kódu odpovídalo vašemu projektu.

V režimu sledování Glaze sleduje nastavený atribut, takže změna hodnoty data-move u prvku naplánuje nové sestavení.

Syntaxe založená na třídách

Dáváte přednost třídám před datovými atributy? Zapněte režim tříd:

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

Nyní můžete zapisovat animace jako třídy:

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

To se hodí, pokud už používáte utility-first CSS a chcete, aby animace působily podobně. Režim tříd je užitečný také tehdy, když vám šablonovací systém dovoluje přidávat prvku třídy, ale ne libovolné atributy.

Glaze přečte každou třídu, která začíná předponou následovanou pomlčkou (zde animate-), a tuto část odstraní. Tříd bez předpony se nedotkne, takže třídy animací mohou být na stejném prvku vedle tříd pro stylování. Animaci můžete rozdělit do několika tříd:

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

Responzivní třídy přijímají bod zlomu za předponou i před ní. Obě varianty se použijí pouze tehdy, když odpovídá lg bod zlomu:

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

Předvolby fungují stejně i ve třídách, například animate-preset-fadeIn.

Režim tříd nevypíná datový atribut. Pokud ho prvek obsahuje zároveň, Glaze spojí jejich hodnoty do jednoho řetězce: nejprve hodnotu atributu a potom třídy s předponou v pořadí, v jakém se objevují v atributu class.

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

Tento prvek se při každé velikosti animuje z opacity: 0 po dobu jedné sekundy a také z y: 50, pokud odpovídá lg. Protože se řetězce spojí, platí stejné pravidlo jako v jediném řetězci: pokud dvě části nastaví stejnou vlastnost, rozhoduje ta pozdější. Zde hodnota třídy přepíše hodnotu atributu pro x:

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

Prvek se animuje do x: 100 a y: 20.

Když je v režimu tříd zapnuté watch, Glaze sleduje také změny class. Přidání třídy animate- k prvku nebo změna tříd prvku, který Glaze už čte nebo animuje, naplánuje nové sestavení. Změny tříd potomků prvku s relativním selektorem se projeví také, protože mohou změnit, čemu selektor odpovídá. Změny tříd ostatních prvků se neprojeví; to platí i pro předky animovaných prvků, takže přepnutí třídy tmavého režimu na <html> nebo třídy uzamčení posouvání na <body> běžící animace neovlivní. Nezaznamená se ani změna třídy, kvůli které prvek nově odpovídá globálnímu selektoru; poté zavolejte refresh().

Glaze ve výchozím nastavení prohledává celé document. Předejte element, chcete-li animovat pouze prvky uvnitř kontejneru:

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

element přijímá Element nebo Document. Omezuje tři věci:

  • Kvůli animačním utilitám se prohledává pouze kořenový prvek a jeho potomci. Prvky jinde na stránce se ignorují, i když obsahují data-animate.
  • Režim sledování zaznamenává pouze změny uvnitř kořenového prvku.
  • destroy() uklízí pouze to, co vytvořila tato instance, takže animace ostatních částí stránky zůstanou zachovány.

Díky tomu je element vhodnou volbou pro komponentové frameworky. Pro každou připojenou komponentu vytvořte jednu instanci s kořenovým prvkem komponenty a při jejím odpojení zavolejte destroy(), jak ukazuje část Aktualizace a úklid. Každé instanci přiřaďte samostatný kořenový prvek; prvek uvnitř dvou kořenových prvků animují obě instance.

Cílení na jiné prvky

Výše uvedené možnosti určují, které prvky Glaze načítá. Selektor v hranatých závorkách na začátku segmentu určuje, na které prvky se animace použije. Pokud žádný není uveden, animace cílí na prvek obsahující utility.

Relativní selektory

Selektor začínající na & se vyhodnocuje vzhledem k samotnému prvku, který zastupuje &. Vyhledá se pomocí querySelectorAll, takže může odpovídat několika prvkům:

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

[&>li] odpovídá přímým potomkům li. Hodnota stagger rozestoupí časy jejich začátku o 0,1 sekundy. Použijte ji, když má jeden prvek řídit animaci seznamu, mřížky nebo skupiny potomků bez přidávání atributu ke každému potomkovi.

Mezery zapisujte jako podtržítka. [&_p] se změní na & p a odpovídá každému p uvnitř prvku v libovolné hloubce:

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

Každé podtržítko v selektoru se změní na mezeru, takže takto nelze vyhledat název třídy, který podtržítko obsahuje.

[&] samostatně označuje samotný element. Většinou se používá jako hodnota, například scrollTrigger.trigger-[&] v ScrollTrigger a v časové ose defaults.

Globální selektory

Selektor bez & se předává animačnímu enginu jako řetězec. GSAP a Motion jej vyhodnocují v celém dokumentu, nikoli vzhledem k prvku nebo kořenovému prvku element:

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

Tím se animuje každý .badge na stránce bez ohledu na jeho umístění. V opakovaně použitelných komponentách upřednostňujte relativní selektory, protože globální selektor odpovídá i kopiím komponenty na jiných místech stránky.

Omezení

Každý prvek má jeden cíl. Pokud selektor obsahuje více segmentů, poslední z nich se použije pro všechny stavy prvku. Zde se na p použijí from i to, nikoli na h1:

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

Chcete-li animovat dvě skupiny odlišně, umístěte utility přímo na potomky nebo je seskupte do časové osy.

Selektor končí u prvního ], takže selektory obsahující hranaté závorky, například selektory atributů jako [&>[data-item]], nejsou podporovány. Použijte místo nich selektor třídy nebo prvku.

Selektory se kombinují s body zlomu v pořadí popsaném v části Syntaxe, například @lg:[&>div]:from:opacity-0.