Μετάβαση στο περιεχόμενο

Επιλογείς

Από προεπιλογή, το Glaze αναζητά στοιχεία με το χαρακτηριστικό data-animate και δημιουργεί την κινούμενη εικόνα με βάση την τιμή αυτού του χαρακτηριστικού. Αυτή η σελίδα καλύπτει τις τρεις επιλογές που αλλάζουν ποια στοιχεία διαβάζει το Glaze: τις επιλογές dataAttribute, className και element, καθώς και τους επιλογείς σε αγκύλες που κατευθύνουν την κινούμενη εικόνα σε άλλα στοιχεία. Τα βοηθητικά στοιχεία μέσα στη συμβολοσειρά περιγράφονται στην ενότητα Σύνταξη.

Πώς εντοπίζονται τα στοιχεία

Όταν εκτελείται το glaze(), καθώς και σε κάθε refresh() ή ανακατασκευή σε λειτουργία παρακολούθησης, διατρέχει όλα τα στοιχεία μέσα στη ρίζα και επιλέγει όσα έχουν το διαμορφωμένο χαρακτηριστικό ή, στη λειτουργία κλάσεων, μια κλάση με το διαμορφωμένο πρόθεμα. Ως ριζικό στοιχείο υπολογίζεται και το ίδιο το στοιχείο, αν έχει το χαρακτηριστικό. Τα στοιχεία διαβάζονται με τη σειρά του εγγράφου.

Κάθε στοιχείο που εντοπίζεται με αυτόν τον τρόπο αποκτά τη δική του χρονογραμμή, εκτός αν βρίσκεται μέσα σε στοιχείο tl ή συνδέεται με ένα τέτοιο στοιχείο μέσω του tl:<id>. Σε αυτήν την περίπτωση, προστίθεται στην ίδια χρονογραμμή. Δείτε τις Χρονογραμμές για να μάθετε πώς λειτουργεί η ομαδοποίηση.

Προσαρμοσμένο χαρακτηριστικό

Χρησιμοποιήστε ένα διαφορετικό χαρακτηριστικό δεδομένων:

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

Τώρα το Glaze θα αναζητά το data-move αντί για το data-animate:

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

Η επιλογή αντικαθιστά το χαρακτηριστικό αντί να προσθέτει ένα. Με την παραπάνω ρύθμιση, ένα στοιχείο που εξακολουθεί να έχει το data-animate αγνοείται. Χρησιμοποιήστε την όταν κάποιο άλλο script στη σελίδα διαβάζει ήδη το data-animate ή όταν θέλετε η σήμανση να ονομάζει το χαρακτηριστικό σύμφωνα με το έργο σας.

Στη λειτουργία παρακολούθησης, το Glaze παρακολουθεί το ρυθμισμένο χαρακτηριστικό, οπότε η αλλαγή της τιμής του data-move σε ένα στοιχείο προγραμματίζει μια ανακατασκευή.

Σύνταξη βάσει κλάσεων

Προτιμάτε τις κλάσεις αντί για χαρακτηριστικά δεδομένων; Ενεργοποιήστε τη λειτουργία κλάσεων:

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

Τώρα μπορείτε να γράφετε animation ως κλάσεις:

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

Αυτό λειτουργεί καλά αν χρησιμοποιείτε ήδη το utility-first CSS και θέλετε οι κινούμενες εικόνες σας να έχουν παρόμοια αίσθηση. Η λειτουργία κλάσεων είναι επίσης χρήσιμη όταν ένα σύστημα προτύπων σάς επιτρέπει να προσθέτετε κλάσεις σε ένα στοιχείο, αλλά όχι αυθαίρετα χαρακτηριστικά.

Το Glaze διαβάζει κάθε κλάση που αρχίζει με το πρόθεμα ακολουθούμενο από παύλα (animate- εδώ) και αφαιρεί αυτό το τμήμα. Οι κλάσεις χωρίς το πρόθεμα παραμένουν ως έχουν, ώστε οι κλάσεις κίνησης να μπορούν να συνυπάρχουν με κλάσεις μορφοποίησης στο ίδιο στοιχείο. Μπορείτε να χωρίσετε μια κίνηση σε πολλές κλάσεις:

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

Οι προσαρμοστικές κλάσεις δέχονται το σημείο διακοπής είτε μετά είτε πριν από το πρόθεμα. Και οι δύο εκδοχές εκτελούνται μόνο όταν ταιριάζει το σημείο lg διακοπής:

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

Οι Προεπιλογές λειτουργούν με τον ίδιο τρόπο στις κλάσεις, για παράδειγμα animate-preset-fadeIn.

Η λειτουργία κλάσεων δεν απενεργοποιεί το χαρακτηριστικό δεδομένων. Όταν ένα στοιχείο έχει και τα δύο, το Glaze τα συνενώνει σε μία συμβολοσειρά: πρώτα την τιμή του χαρακτηριστικού και έπειτα τις κλάσεις με πρόθεμα, με τη σειρά που εμφανίζονται στο χαρακτηριστικό class.

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

Αυτό το στοιχείο κινείται από το opacity: 0 για ένα δευτερόλεπτο σε κάθε μέγεθος και επίσης από το y: 50 όταν ταιριάζει το lg. Επειδή οι συμβολοσειρές συνενώνονται, ισχύει ο ίδιος κανόνας όπως και μέσα σε μία συμβολοσειρά: όταν δύο μέρη ορίζουν την ίδια ιδιότητα, υπερισχύει το μεταγενέστερο. Εδώ, η τιμή της κλάσης υπερισχύει της τιμής του χαρακτηριστικού για το x:

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

Το στοιχείο κινείται προς τα x: 100 και y: 20.

Με ενεργοποιημένο το watch στη λειτουργία κλάσεων, το Glaze παρακολουθεί επίσης αλλαγές στο class. Η προσθήκη μιας κλάσης animate- σε ένα στοιχείο ή η αλλαγή των κλάσεων ενός στοιχείου που Glaze ήδη διαβάζει ή κινεί, προγραμματίζει ανακατασκευή. Μέσα σε ένα στοιχείο με σχετικό επιλογέα, αλλαγές κλάσεων στους απογόνους του προκαλούν επίσης ανακατασκευή, επειδή μπορούν να αλλάξουν τα στοιχεία που αντιστοιχούν στον επιλογέα. Οι αλλαγές κλάσεων σε άλλα στοιχεία δεν την προκαλούν, συμπεριλαμβανομένων των προγόνων των στοιχείων που κινούνται. Επομένως, η εναλλαγή μιας κλάσης σκοτεινής λειτουργίας στο <html> ή μιας κλάσης κλειδώματος κύλισης στο <body> δεν επηρεάζει τις κινούμενες διεργασίες. Επίσης, δεν εντοπίζεται αλλαγή κλάσης που κάνει ένα στοιχείο να αντιστοιχεί πλέον σε έναν καθολικό επιλογέα· καλέστε το refresh() μετά.

Το Glaze αναζητά από προεπιλογή σε όλο το document. Περάστε το element για να κινεί μόνο τα στοιχεία μέσα σε ένα κοντέινερ:

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

Το element δέχεται ένα Element ή ένα Document. Περιορίζει τρία πράγματα:

  • Για βοηθητικές κλάσεις κίνησης γίνεται σάρωση μόνο της ρίζας και των απογόνων της. Τα στοιχεία σε άλλα σημεία της σελίδας αγνοούνται, ακόμη κι αν έχουν το data-animate.
  • Η λειτουργία παρακολούθησης παρατηρεί μόνο τις μεταβολές μέσα στη ρίζα.
  • Το destroy() καθαρίζει μόνο όσα δημιούργησε αυτή η παρουσία, ώστε οι κινήσεις στα υπόλοιπα μέρη της σελίδας να συνεχίζονται.

Έτσι, το element είναι η κατάλληλη επιλογή για πλαίσια εργασίας στοιχείων. Δημιουργήστε μία παρουσία ανά προσαρτημένο στοιχείο, χρησιμοποιώντας το ριζικό στοιχείο του, και καλέστε το destroy() όταν αποπροσαρτάται, όπως φαίνεται στην ενότητα Ανανέωση και εκκαθάριση. Ορίστε ξεχωριστές ρίζες για τις παρουσίες, χωρίς αλληλεπικάλυψη· ένα στοιχείο μέσα σε δύο ρίζες κινείται και από τις δύο παρουσίες.

Στόχευση άλλων στοιχείων

Οι παραπάνω επιλογές καθορίζουν ποια στοιχεία διαβάζει το Glaze. Ένας επιλογέας σε αγκύλες στην αρχή ενός τμήματος καθορίζει σε ποια στοιχεία εφαρμόζεται η κίνηση. Χωρίς επιλογέα, η κίνηση στοχεύει το στοιχείο που φέρει τις βοηθητικές κλάσεις.

Σχετικοί επιλογείς

Ένας επιλογέας που αρχίζει με & επιλύεται με αφετηρία το ίδιο το στοιχείο, με το & να αντιπροσωπεύει αυτό το στοιχείο. Το ερώτημα γίνεται με το querySelectorAll, επομένως μπορεί να αντιστοιχεί σε πολλά στοιχεία:

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

Το [&>li] αντιστοιχεί στα άμεσα θυγατρικά li. Η τιμή stagger απέχει τους χρόνους έναρξής τους κατά 0.1 δευτερόλεπτα. Χρησιμοποιήστε το όταν ένα στοιχείο πρέπει να ελέγχει την κίνηση μιας λίστας, ενός πλέγματος ή μιας ομάδας θυγατρικών, χωρίς να προσθέσετε χαρακτηριστικό σε κάθε θυγατρικό στοιχείο.

Γράψτε τα κενά ως κάτω παύλες. Το [&_p] γίνεται & p και αντιστοιχεί σε κάθε p μέσα στο στοιχείο, σε οποιοδήποτε βάθος:

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

Κάθε κάτω παύλα σε έναν επιλογέα μετατρέπεται σε κενό, επομένως δεν είναι δυνατό να αντιστοιχιστεί με αυτόν τον τρόπο ένα όνομα κλάσης που περιέχει κάτω παύλα.

Το [&] από μόνο του επιλύεται στο ίδιο το στοιχείο. Χρησιμοποιείται κυρίως ως τιμή, για παράδειγμα scrollTrigger.trigger-[&] στην ενότητα ScrollTrigger και στις προεπιλογές χρονογραμμής.

Καθολικοί επιλογείς

Ένας επιλογέας χωρίς & περνά στη μηχανή κίνησης ως συμβολοσειρά. Τα GSAP και Motion επιλύουν την επιλογή σε ολόκληρο το έγγραφο, όχι στο στοιχείο ή στη ρίζα του element:

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

Αυτό κινεί κάθε .badge στη σελίδα, όπου κι αν βρίσκεται. Προτιμήστε σχετικούς επιλογείς μέσα σε επαναχρησιμοποιήσιμα στοιχεία, επειδή ένας καθολικός επιλογέας αντιστοιχεί και σε αντίγραφα του στοιχείου σε άλλα σημεία της σελίδας.

Περιορισμοί

Κάθε στοιχείο έχει έναν στόχο. Όταν πολλά τμήματα περιέχουν επιλογέα, το τελευταίο εφαρμόζεται σε όλες τις καταστάσεις του στοιχείου. Εδώ, τόσο το from όσο και το to εφαρμόζονται στο p, όχι στο h1:

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

Για να κινήσετε διαφορετικά δύο ομάδες, τοποθετήστε τις βοηθητικές κλάσεις στα ίδια τα θυγατρικά στοιχεία ή ομαδοποιήστε τα σε μια χρονογραμμή.

Ένας επιλογέας τελειώνει στην πρώτη ], επομένως δεν υποστηρίζονται επιλογείς που περιέχουν αγκύλες, όπως οι επιλογείς χαρακτηριστικών τύπου [&>[data-item]]. Χρησιμοποιήστε επιλογέα κλάσης ή στοιχείου.

Οι επιλογείς συνδυάζονται με τα σημεία διακοπής με τη σειρά που περιγράφεται στην ενότητα Σύνταξη, για παράδειγμα @lg:[&>div]:from:opacity-0.