How shopify/draggable works
Draggable is a browser drag-and-drop library: input sensors detect native, mouse, touch, or force-touch gestures; the Draggable engine turns sensor activity into drag lifecycle events and manages mirrors and plugins; higher-level modules add sorting, dropping, and swapping. The README documents the broader plugin capabilities. Some plugin and sensor implementations were not sampled, so their links are included only where the README or SOURCE INDEX supports them; no storage or external service is involved.
Main entry points: Draggable.js Draggable engine · DragEvent.ts Drag lifecycle events · index.js Public API exports · Sortable.js Sortable behavior
Components 23
Gesture input
- Mouse sensor
src/Draggable/Sensors/MouseSensor/MouseSensor.js - Touch sensor
src/Draggable/Sensors/TouchSensor/TouchSensor.js - Native drag sensor
src/Draggable/Sensors/DragSensor/DragSensor.js - Force-touch sensor
src/Draggable/Sensors/ForceTouchSensor/ForceTouchSensor.js - Sensor base and events
src/Draggable/Sensors/Sensor/Sensor.js
Drag engine
- Draggable engine
src/Draggable/Draggable.js - Drag lifecycle events
src/Draggable/DragEvent/DragEvent.ts - Engine events
src/Draggable/DraggableEvent/DraggableEvent.ts - Event emitter
src/Draggable/Emitter/Emitter.ts - Drag mirror
src/Draggable/Plugins/Mirror/Mirror.js - Built-in plugins
src/Draggable/Plugins
Drag behaviors
- Sortable behavior
src/Sortable/Sortable.js - Droppable behavior
src/Droppable/Droppable.js - Swappable behavior
src/Swappable/Swappable.js
Plugins and extensions
- Collision detection
src/Plugins/Collidable/Collidable.js - Snap behavior
src/Plugins/Snappable/Snappable.js - Mirror resizing
src/Plugins/ResizeMirror/ResizeMirror.ts - Sort animation
src/Plugins/SortAnimation/SortAnimation.js - Swap animation
src/Plugins/SwapAnimation/SwapAnimation.ts
Shared foundation
- Base event
src/shared/AbstractEvent/AbstractEvent.ts - Base plugin
src/shared/AbstractPlugin/AbstractPlugin.ts - Public API exports
src/index.js
Other components
- Browser user
Connections 33
- Browser user → Mouse sensor: uses
README.md - Browser user → Touch sensor: uses
README.md - Browser user → Native drag sensor: uses
README.md - Browser user → Force-touch sensor: uses
README.md - Mouse sensor → Sensor base and events: extends
- Touch sensor → Sensor base and events: extends
- Native drag sensor → Sensor base and events: extends
src/Draggable/Sensors/DragSensor/DragSensor.js - Force-touch sensor → Sensor base and events: extends
- Draggable engine → Mouse sensor: attaches
src/Draggable/Draggable.js - Draggable engine → Touch sensor: attaches
src/Draggable/Draggable.js - Native drag sensor → Draggable engine: emits sensor events
src/Draggable/Sensors/DragSensor/DragSensor.js - Draggable engine → Drag lifecycle events: creates
src/Draggable/Draggable.js - Draggable engine → Event emitter: dispatches through
src/Draggable/Draggable.js - Draggable engine → Engine events: creates
src/Draggable/Draggable.js - Draggable engine → Drag mirror: manages
README.md - Draggable engine → Built-in plugins: supports
README.md - Sortable behavior → Draggable engine: extends
src/Sortable/Sortable.js - Sortable behavior → Drag lifecycle events: handles
src/Sortable/Sortable.js - Droppable behavior → Draggable engine: extends
src/Droppable/Droppable.js - Droppable behavior → Drag lifecycle events: handles
src/Droppable/Droppable.js - Swappable behavior → Draggable engine: extends
src/Swappable/Swappable.js - Swappable behavior → Drag lifecycle events: handles
src/Swappable/Swappable.js - Collision detection → Drag lifecycle events: extends collision events
- Snap behavior → Draggable engine: extends behavior
- Mirror resizing → Drag mirror: resizes
- Sort animation → Sortable behavior: animates sorting
- Swap animation → Swappable behavior: animates swapping
- Draggable engine → Base event: uses base events
- Built-in plugins → Base plugin: uses base plugin
- Public API exports → Draggable engine: exports
src/index.js - Public API exports → Sortable behavior: exports
src/index.js - Public API exports → Droppable behavior: exports
src/index.js - Public API exports → Swappable behavior: exports
src/index.js