Usage notes
The context combines app-owned drag data with the resolved timeline target. Use it to build clip placements from a media bin, asset browser, file picker, or generated content panel. Times are already converted from pointer position into RationalTime so placement factories do not need to duplicate timeline geometry math.
Signature
Interface TimelineExternalClipDropContextType parameters
| Name | Constraint | Default | Description |
|---|---|---|---|
DragData | None | None | App-owned payload resolved from the native drag event. |
TrackKind | None | string | App-defined track kind values accepted by the drop surface. |
Properties
| Name | Signature | Description |
|---|---|---|
data | data: DragData | App-owned drag payload resolved from the native drag event. |
dataTransfer | dataTransfer: DataTransfer | Native browser data transfer payload. |
dropSeconds | dropSeconds: number | Timeline seconds under the pointer. |
dropTime | dropTime: RationalTime | Timeline time under the pointer. |
editMode | editMode: TimelineExternalClipDropEditMode | Edit operation selected for this drop. |
event | event: DragEvent<HTMLElement> | Native React drag event for advanced app integrations. |
targetTrack | targetTrack: Track<TrackKind> | Track currently under the pointer. |
targetTrackIndex | targetTrackIndex: number | Zero-based index of the target track. |
viewportX | viewportX: number | Horizontal pointer position inside the drop surface. |
viewportY | viewportY: number | Vertical pointer position inside the drop surface. |