Documentation is work in progress and not completeEditor
Text
Stagger and Per-Unit Animation
Stagger System
Rather than manually keyframing each character, word, or line individually, the stagger system applies a time offset to each successive unit, creating a sequential animation cascade automatically.
Stagger Settings:
- -Delay per Unit — time in milliseconds between the start of each successive unit's animation. Default: 50ms.
- -Stagger Direction — Forward (first character first), Backward (last character first), From Center (outward from center), From Edges (inward toward center), Random (each unit starts at a random delay within a configurable range)
- -Easing Override — an easing curve applied to the stagger timing envelope itself, separate from the easing applied to each unit's individual animation
Per-Unit Properties
When stagger is active, the following properties can be defined as the animated state that each unit transitions from:
| Property | Description |
|---|---|
| Opacity | Fade in from 0% opacity |
| Position X / Y | Slide in from an offset position |
| Scale X / Y | Scale in from a smaller or larger size |
| Rotation | Rotate in from a defined angle |
| Blur | Defocus in from a blurred state |
| Color | Transition from an alternate color to the primary color |
| Skew X / Y | Straighten in from a skewed state |
| Baseline Shift | Rise up from below the baseline |
Multiple properties can be combined. Example: entering from opacity 0, position Y +30px, blur radius 8px simultaneously creates a "lift in from below while fading and sharpening" effect.
Stagger with Manual Overrides
The stagger system provides automated timing, but individual units can receive manual overrides on top of the stagger:
- -Select a specific unit's keyframe in the timeline
- -Adjust the keyframe position to deviate from the stagger timing
- -Add additional keyframes for properties not covered by the stagger definition