Help guide

Drag Input node

Updated June 21, 2026

Product media placeholder

Replace this area with a screenshot or short walkthrough video during the media sweep.

DEPRECATED for new authoring — prefer `dragVelocity` (passive sensor) wired into a `scrollPosition` or a translateX expression. `dragInput` wraps the internal Draggable utility, which physically translates the bound element via inline `transform` writes to drive its own progress reading. That hijacks the element: it can't coexist with a pinned section, an existing transform, or another node that needs the same DOM space. Kept as a stable boundary input for legacy `.fmtion` files; new graphs should not introduce it. Boundary input: binds pointer events to a DOM element and maps drag offset to 0-1 progress on the configured axis. Supports parent-bounded range and inertia throw.

Type dragInputCategory inputsContext domDynamic ports noCompound no

Inputs

PortTypeDescription
externalProgressfloatExternal Progress

Outputs

PortTypeDescription
progressfloatProgress

Parameters

ParameterTypeDefaultDescription
selectorstring""CSS Selector
axisenum"x"Axis options x, y
boundsenum"parent"Bounds options , parent, window
inertiabool-Inertia
accumulateboolfalseWhen true, drag offset PERSISTS across drag sessions — each new drag continues from the previous drag-end offset instead of resetting to 0. Right for swipe-pan carousels and "scrub-forever" patterns. Default false matches slider/knob behaviour where each touch is a fresh delta from origin.

Related nodes

Envelope

Use dragInput as the node type inside a graph node envelope. Add id, optional params, optional connections, and optional activeWhen based on the guide context.

Generated source

Registry faster-motion-docs/node-registry.jsonCategory page /help/faster-motion/faster-motion-node-category-inputs/

Was this guide helpful?

Sunny Arora

Written by

Sunny Arora

Get technical deep dives delivered to your inbox

Join creators and developers who get exclusive insights, tutorials, and behind-the-scenes content every week.

No spam. Unsubscribe anytime.

Continue Exploring

You might also enjoy