- Removed `PATCH_PROP_KEYS` and `PatchProps`, streamlining property management as the document structure no longer requires patching by prop name. - Updated type definitions to introduce new internal prop groups (`IdentityProps`, `PositionProps`, `OffsetProps`, `SizeProps`, `TransformProps`, `TimingProps`, `SequenceItemProps`), enhancing clarity and organization of properties. - Refactored animation and keyframe structures to utilize `<animation>` and `<keyframeTrack>` elements, ensuring consistent handling of animatable properties. - Updated migration documentation to reflect the removal of obsolete structures and the introduction of new prop groups, detailing their usage in the context of animations and keyframes.
2.8 KiB
2.8 KiB
Keyframes
A <keyframeTrack> animates one prop of the element holding it over the node's local time; its <keyframe> children are the values along the way:
<image src="/photo.jpg" start={0} end={5}>
<keyframeTrack property="x">
<keyframe time={0} value={-400} easing="easeOut" />
<keyframe time={1} value={200} />
</keyframeTrack>
<keyframeTrack property="opacity">
<keyframe time={0} value={0} />
<keyframe time="15f" value={1} />
</keyframeTrack>
</image>
| Element | Props | Meaning |
|---|---|---|
<keyframeTrack> |
property (required) |
The prop of the holding element it drives, by name. One track per prop. |
<keyframe> |
time (required), value (required), easing |
One keyframe: node-local time in any time format, the value at that time (a number, or any CSS color on a color track), and the easing into the next keyframe. |
Animatable props (property): x, y, offsetX, offsetY, width, height, rotation, opacity, cornerRadius, volume, color, offset, blur, value. Whose prop is the track's holder's: a track under a paint or color stop animates the paint (color, opacity, offset), under a <stroke> the stroke (width is the line width), under a <shadow> the shadow (blur, offsetX, offsetY), under an <effect> its value. For preset in/out effects (fade, slides, text reveals, ...) use <animation> instead.
Semantics
timeis node-local:0is where the clip begins (itsstart). Timing props are parent-relative; keyframe times are not, so animation moves with the clip.- Keyframes may be written in any order; they sort by
time. Outside the keyframed range the value holds at the first/last keyframe. easingshapes the segment from its keyframe to the next; the last keyframe's easing is ignored. Default"linear".- The prop's static value (
x={10}on the element) is what holds when the track has no keyframes; while it has any, the track wins. - Tracks and keyframes are elements like any other: each has an
id, the editor writes a moved keyframe back to it, and they are copied with their element.
Easing
| Easing | Use for |
|---|---|
"linear" (default) |
Constant-rate change. |
"easeIn", "easeOut", "easeInOut" |
Standard acceleration curves (CSS equivalents). |
"gentle", "snappy", "bouncy", "strong" |
Spring presets, from soft settle to hard overshoot. |
"cubicBezier(x1,y1,x2,y2)" |
Custom curve, CSS control points. |
"spring(bounce,duration)" |
Custom spring: bounce 0-1, duration in ms. |
"steps(n)" |
Discrete hold: n equal steps, no interpolation. |
Named presets expand to the same descriptors the editor's interpolation inspector writes, so they round-trip cleanly.