Skip to main content

Dnd Strategy

dndStrategy selects which drag-and-drop implementation drives the dock. The default ('auto') covers desktop and touch with no further configuration.

ValueBehaviour
'auto' (default)HTML5 drives mouse drags; pointer events drive touch and pen drags.
'pointer'Pointer events drive every input type. Useful where HTML5 drag-and-drop is unreliable (some Linux browsers, certain Safari versions, embedded webviews). Cross-window HTML5 drag and the native browser drag image are not available in this mode.
'html5'HTML5 drag-and-drop only — touch and pen drags are disabled.

disableDnd: true overrides every strategy. The strategy can also be changed at runtime via api.updateOptions({ dndStrategy: ... }); the change propagates to every existing drag source.

Touch gestures

Under 'auto' and 'pointer', touch drags use a long-press-then-drag gesture so taps and native scroll still work.

GestureResult
Tapclick fires normally; no drag
Quick horizontal swipe across the tab stripBrowser scrolls natively
Hold ~250 ms, then moveDrag arms; ghost follows the finger
Hold ~500 ms stillContext menu opens; any in-flight drag arm is cancelled
Release without movementNothing
Newsletter