mzabriskie/react-draggable
React Draggable
react-draggable is a UI interaction library that provides core primitives and components for adding tactile movement and coordinate-based positioning to web elements. It serves as a tool for making user interface elements movable via mouse or touch interactions within React applications.
The library supports the implementation of custom drag handles, allowing the initiation of movement to be restricted to specific child elements identified by CSS selectors. It also provides programmatic drag state management, enabling developers to control element positioning or use callbacks for movement without automatic style management.
The project covers a broad range of interaction capabilities, including drag event tracking through lifecycle callbacks and the enforcement of boundary constraints to restrict movement within defined dimensions. It supports both desktop and mobile devices through touch-enabled element positioning.
Features
- Drag and Drop Libraries - Provides low-level primitives for managing coordinates and movement of elements on a screen.
- React Components - Offers reusable draggable components specifically designed for integration within the React ecosystem.
- Spatial State Tracking - Tracks real-time mouse and touch coordinates to maintain the spatial state of moving elements.
- Element Positioning - Implements element positioning that works across both desktop and mobile touch interfaces.
- Drag Handles - Allows restricting the movement of an element to a specific designated child handle.
- Interactive UI Components - Provides components that can be freely moved across the screen via mouse or touch interactions.
- Draggable Layout Elements - Provides UI components that can be freely repositioned across the screen via pointer interactions.
- CSS Transform Animations - Uses inline CSS transform properties to ensure smooth, hardware-accelerated movement of elements.
- Dynamic Layout Engines - Provides a framework for programmatically controlling element positions and reacting to movement via callbacks.
- Drag Boundary Constraints - Implements boundaries to restrict the movement of draggable elements within defined coordinate areas.
- Drag Event Callbacks - Ships configuration hooks that execute custom functions during the start, progression, and completion of drags.
- Drag State Monitors - Offers tools to monitor drag progress and control element coordinates programmatically.
- Drag and Drop - Draggable element component.
