Seletores
Por padrão, Glaze procura elementos com o atributo data-animate e cria a animação com base no valor desse atributo. Esta página aborda as três opções que alteram quais elementos Glaze lê: dataAttribute, className e element, além dos seletores entre colchetes que direcionam uma animação a outros elementos. Os utilitários dentro da string são descritos em Sintaxe.
Como os elementos são encontrados
Quando glaze() é executado, e novamente em cada reconstrução de refresh() ou do modo de monitoramento, ele percorre todos os elementos dentro da raiz e mantém aqueles que têm o atributo configurado ou, no modo de classe, uma classe com o prefixo configurado. O próprio elemento raiz também é considerado quando contém um deles. Os elementos são lidos na ordem do documento.
Cada elemento encontrado dessa forma recebe sua própria linha do tempo, a menos que esteja dentro de um elemento tl ou esteja vinculado a um por meio de tl:<id>. Nesse caso, ele é adicionado àquela linha do tempo. Consulte Linhas do tempo para saber como funciona o agrupamento.
Atributo personalizado
Use um atributo de dados diferente:
glaze({
lib: { gsap: { core: gsap } },
dataAttribute: "data-move",
})
Agora, Glaze procurará data-move em vez de data-animate:
<div data-move="from:opacity-0"></div>
A opção substitui o atributo em vez de adicionar um. Com a configuração acima, um elemento que ainda tenha data-animate será ignorado. Use-a quando outro script na página já lê data-animate ou quando quiser que a marcação nomeie o atributo conforme o seu projeto.
No modo de observação, Glaze observa o atributo configurado; assim, alterar o valor de data-move em um elemento agenda uma recompilação.
Sintaxe baseada em classes
Prefere usar classes em vez de atributos de dados? Ative o modo de classes:
glaze({
lib: { gsap: { core: gsap } },
className: "animate",
})
Agora você pode escrever animações como classes:
<div class="animate-from:opacity-0|duration-1"></div>
Isso funciona bem se você já usa CSS utilitário-primeiro e quer que suas animações tenham uma aparência semelhante. O modo de classes também é útil quando um sistema de templates permite adicionar classes a um elemento, mas não atributos arbitrários.
Glaze lê todas as classes que começam com o prefixo seguido de um hífen (animate- aqui) e remove essa parte. As classes sem o prefixo permanecem intactas, então as classes de animação podem ficar ao lado das classes de estilo no mesmo elemento. Você pode dividir uma animação em várias classes:
<div class="card animate-from:opacity-0 animate-from:y-24"></div>
As classes responsivas aceitam o ponto de interrupção depois ou antes do prefixo. Ambas são executadas somente quando o lg ponto de interrupção corresponde:
<div class="animate-@lg:from:opacity-0"></div>
<div class="@lg:animate-from:opacity-0"></div>
Predefinições funcionam da mesma forma nas classes, por exemplo animate-preset-fadeIn.
O modo de classes não desativa o atributo de dados. Quando um elemento tem ambos, Glaze os combina em uma única string: primeiro o valor do atributo e, em seguida, as classes com prefixo na ordem em que aparecem no atributo class.
<div
class="animate-from:opacity-0 animate-@lg:from:y-50"
data-animate="from:duration-1"
></div>
Este elemento anima a partir de opacity: 0 por um segundo em qualquer tamanho e também a partir de y: 50 quando lg corresponde. Como as strings são combinadas, aplica-se a mesma regra de uma única string: quando duas partes definem a mesma propriedade, prevalece a última. Aqui, o valor da classe substitui o valor do atributo para x:
<div class="animate-to:x-100" data-animate="to:x-50|y-20"></div>
O elemento anima até x: 100 e y: 20.
Com watch ativado no modo de classes, Glaze também observa alterações em class. Adicionar uma classe animate- a um elemento ou alterar as classes de um elemento que Glaze já lê ou anima agenda uma reconstrução. Dentro de um elemento com um seletor relativo, as alterações de classe nos descendentes também são observadas, pois podem mudar o que o seletor corresponde. As alterações de classe em outros elementos não são observadas, inclusive nos ancestrais dos elementos animados. Assim, alternar uma classe de modo escuro em <html> ou uma classe de bloqueio de rolagem em <body> não afeta as animações em andamento. Uma alteração de classe que faz um elemento passar a corresponder a um seletor global também não é detectada; chame refresh() depois disso.
Limitando a busca
Glaze pesquisa todo o document por padrão. Passe element para animar somente elementos dentro de um contêiner:
glaze({
lib: { gsap: { core: gsap } },
element: document.querySelector("#app"),
})
element aceita um Element ou um Document. Ele limita três aspectos:
- Somente a raiz e seus descendentes são examinados em busca de utilitários de animação. Elementos em outras partes da página são ignorados, mesmo quando têm
data-animate. - O modo de observação monitora apenas as mutações dentro da raiz.
destroy()limpa apenas o que esta instância criou, para que as animações das outras partes da página permaneçam.
Isso torna element a opção ideal em frameworks de componentes. Crie uma instância para cada componente montado, usando o elemento raiz do componente, e chame destroy() ao desmontá-lo, como mostrado em Atualização e limpeza. Use raízes que não se sobreponham para instâncias separadas; um elemento dentro de duas raízes é animado por ambas as instâncias.
Como direcionar outros elementos
As opções acima determinam quais elementos Glaze lê. Um seletor entre colchetes no início de um segmento determina a quais elementos a animação se aplica. Sem um seletor, a animação tem como alvo o elemento que contém os utilitários.
Seletores relativos
Um seletor que começa com & é resolvido a partir do próprio elemento, sendo & a referência a esse elemento. A consulta é feita com querySelectorAll, portanto pode corresponder a vários elementos:
<ul data-animate="[&>li]:from:opacity-0|y-20|stagger-0.1">
<li>One</li>
<li>Two</li>
<li>Three</li>
</ul>
[&>li] corresponde aos elementos filhos li diretos. O valor stagger separa os horários de início em 0.1 segundos. Use-o quando um elemento deve controlar a animação de uma lista, grade ou grupo de elementos filhos sem adicionar um atributo a cada filho.
Escreva espaços como sublinhados. [&_p] se transforma em & p e corresponde a todos os p dentro do elemento, em qualquer profundidade:
<article data-animate="[&_p]:from:opacity-0|stagger-0.2">
<p>First paragraph</p>
<div><p>Nested paragraph</p></div>
</article>
Cada sublinhado em um seletor é convertido em espaço, então não é possível corresponder dessa forma a um nome de classe que contenha um sublinhado.
[&] sozinho corresponde ao próprio elemento. É usado principalmente como valor, por exemplo scrollTrigger.trigger-[&] em ScrollTrigger e nos valores padrão da linha do tempo.
Seletores globais
Um seletor sem & é passado como string para o mecanismo de animação. GSAP e Motion o resolvem em relação ao documento inteiro, não ao elemento nem à raiz element:
<h2 data-animate="[.badge]:from:opacity-0|scale-0.5|duration-0.3">Inbox</h2>
<span class="badge">3</span>
Isso anima todos os .badge da página, onde quer que estejam. Prefira seletores relativos em componentes reutilizáveis, pois um seletor global também corresponde a cópias do componente em outras partes da página.
Limitações
Cada elemento tem um único alvo. Quando vários segmentos contêm um seletor, o último se aplica a todos os estados do elemento. Aqui, tanto from quanto to se aplicam ao p, não ao h1:
<div data-animate="[&>h1]:from:opacity-0 [&>p]:to:x-20">
<h1>Title</h1>
<p>Text</p>
</div>
Para animar dois grupos de maneiras diferentes, coloque os utilitários nos próprios elementos filhos ou agrupe-os em uma linha do tempo.
Um seletor termina no primeiro ], portanto seletores que contêm colchetes, como seletores de atributo como [&>[data-item]], não são compatíveis. Use um seletor de classe ou de elemento.
Os seletores se combinam com os pontos de interrupção na ordem descrita em Sintaxe, por exemplo @lg:[&>div]:from:opacity-0.