Usage notes
Pass renderer-aligned geometry so pointer Y coordinates resolve to the same
track rows users see on screen. `canDropClipOnTrack` lets applications enforce
domain rules such as preventing audio clips from moving to visual tracks
unless a modifier key or tool mode allows it.
Signature
Interface UseTimelineClipDragOptionsType parameters
| Name | Constraint | Default | Description |
|---|---|---|---|
TrackKind | None | string | App-defined track kind values carried by target tracks,
such as `"visual" | "audio"`. |
Properties
| Name | Signature | Description |
|---|---|---|
canDropClipOnTrack? | canDropClipOnTrack?: TimelineTrackDropGuard<TrackKind> | Optional app policy for accepting, rejecting, or expanding drop targets. |
collapsedTrackHeight? | collapsedTrackHeight?: number | Collapsed track height in pixels. |
edgeThreshold? | edgeThreshold?: number | Mouse/pen edge hit threshold in pixels. |
minVerticalSnapPixels? | minVerticalSnapPixels?: number | Minimum vertical pixels required before snapping vertically. Defaults to 8. |
rulerHeight? | rulerHeight?: number | Height of the top ruler region in pixels. |
touchEdgeThreshold? | touchEdgeThreshold?: number | Touch edge hit threshold in pixels. |
trackHeight? | trackHeight?: number | Default expanded track height in pixels. |
verticalSnapThreshold? | verticalSnapThreshold?: number | Portion of another track the pointer must enter before snapping vertically. Defaults to 0.3. |
viewportWidth? | viewportWidth?: number | Optional viewport width used for track row geometry. |