# Keyframes A `` animates one prop of the element holding it over the node's local time; its `` children are the values along the way: ```tsx ``` | Element | Props | Meaning | | ------- | ----- | ------- | | `` | `property` (**required**) | The prop of the holding element it drives, by name. One track per prop. | | `` | `time` (**required**), `value` (**required**), `easing` | One keyframe: source-local time in any [time format](./timing.md#time-formats), the value at that time (a number, any CSS color on a `color` track, or path data on a `d` track), and the easing into the next keyframe. | Animatable props (`property`): `x`, `y`, `offsetX`, `offsetY`, `width`, `height`, `rotation`, `scale`, `scaleX`, `scaleY`, `opacity`, `cornerRadius`, `cornerRadiusTopLeft`, `cornerRadiusTopRight`, `cornerRadiusBottomRight`, `cornerRadiusBottomLeft`, `volume`, `color`, `offset`, `blur`, `value`, on a [``](./path.md) `d`, `trimStart`, `trimEnd`, `trimOffset`, and on a [``](./styles.md#dashes) `dash`, `dashGap`, `dashOffset`. Whose prop is the track's holder's: a track under a [paint or color stop](./paints.md) animates the paint (`color`, `opacity`, `offset`), and one under a [``, `` or ``](./styles.md) that style's own — `width` is a stroke's line width, `blur`/`offsetX`/`offsetY` a shadow's, `value` an effect's amount. A `d` track morphs a path's outline from one keyframe's path data to the next (see [path.md](./path.md#animating-the-outline)). For preset in/out effects (fade, slides, text reveals, ...) use [``](./animations.md) instead. ## Semantics - `time` is **source-local**: `0` is the first frame of the node's **source**, not where the clip sits on the timeline. A keyframe fires when playback reaches that moment of the content, so animation moves with the clip and stays pinned to the same footage when the head is trimmed. On a clip with [`sourceIn`](./timing.md), a keyframe at `time={t}` therefore plays at clip-relative moment `t - sourceIn`; anything meant relative to the clip's first visible frame must be authored at `sourceIn + t`. For an untrimmed clip (and any node without a source) `0` coincides with the clip's start. ```tsx {/* sourceIn trims 2s off the head, so the clip's first visible frame is source time 2. The fade over its first half second is authored at 2–2.5, not 0–0.5. */} ``` - At a [`playbackRate`](./timing.md#playback-rate) other than `1`, keyframe times stay on the source clock: a keyframe lands on the same content frame at any speed, and the animation speeds up or slows down with the footage. - Keyframes may be written in any order; they sort by `time`. Outside the keyframed range the value holds at the first/last keyframe. - `easing` shapes 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.