Function

useTimelineTimePosition

Imperatively positions a low-count DOM affordance at a timeline time. The returned transform is viewport-space: `seconds * zoomScale - scrollLeft`. Use it for standalone affordances such as the playhead grabber. Range controls that already live inside a transformed timeline overlay should use their local control primitive positioning instead.

Signature

useTimelineTimePosition(options: UseTimelineTimePositionOptions): UseTimelineTimePositionResult<T>

Type parameters

Name	Constraint	Default	Description
`T`	`HTMLElement`	None	No type parameter summary yet.

Parameters

Name	Type	Description
options	UseTimelineTimePositionOptions	Timeline engine, time value, and events that should refresh the transform.

Returns

UseTimelineTimePositionResult<T>

Ref and imperative updater for the positioned element.