bevacqua/dragula
Dragula
Dragula is a JavaScript drag and drop library and DOM element manipulator used to move and reorder HTML elements between multiple containers. It functions as a UI interaction framework and event manager that tracks drag lifecycles to facilitate the movement of elements within a web browser interface.
The library distinguishes itself through configurable constraint validation, allowing developers to define which elements are draggable and which containers are permitted drop targets. It supports specialized interaction patterns such as element cloning, the use of specific drag handles to restrict interaction start points, and a time-based delay to differentiate between static clicks and the start of a drag operation.
The system covers a broad range of movement and visual capabilities, including container-to-container transfers, axis-based orientation control, and the use of mirror shadow elements to visualize potential drop positions. It also provides a suite of lifecycle hooks and callbacks that trigger during drag starts, container overlaps, and final drops, alongside methods for programmatic control of the drag lifecycle.
Features
- Drag and Drop Libraries - Provides a comprehensive library for implementing complex drag-and-drop interactions and workflows.
- Drop Target Validations - Provides configurable validation functions to control which elements can be dropped into specific target areas.
- Drag Lifecycle Events - Tracks lifecycle events such as drag start and drop to trigger custom application logic.
- Cross-Container Transfers - Allows elements to be moved and transferred between multiple different containers via drag and drop.
- Interaction Constraint Logic - Controls which elements can be dragged and which containers are permitted to accept them.
- Drag-and-Drop Row Reorderers - Enables users to manually rearrange the sequence of items within a list or move them between containers.
- Drag and Drop Interactions - Defines the logic and constraints for how elements behave when moved or repositioned by the user.
- Drag-and-Drop Event Callbacks - Exposes a series of callbacks that trigger during specific drag stages for custom logic.
- List Reordering Components - Enables the visual rearrangement of items within lists or moving them between different containers.
- DOM Element Manipulators - Programmatically manages the movement, cloning, and placement of HTML elements within the browser.
- Dynamic DOM Manipulation - Manipulates the document object model to dynamically reorder elements based on cursor coordinates.
- Drag-Click Differentiation - Implements a time-based delay to differentiate between static clicks and the start of a drag operation.
- Click-Drag Differentiation - Uses a time-based delay to prevent drag operations from triggering during simple click events.
- Draggable Filters - Uses custom validation logic to exclude or include specific elements from participating in drag operations.
- Drop Position Previews - Displays a mirror shadow element during drag operations to visualize the potential drop position.
- Drop Target Registries - Evaluates whether a dragged element is permitted to be dropped into a specific target registry.
- Programmatic Triggering - Supports starting or cancelling drag events via function calls to enable keyboard shortcuts and automated logic.
- Ghost Elements - Creates a temporary shadow element that follows the cursor to visualize the potential drop position.
- Interaction Lifecycle Managers - Provides methods for programmatically starting, ending, or canceling drag operations via code.
- Drag Operation Controls - Provides methods to programmatically start, end, or cancel drag operations.
- Drag Handles - Allows restricting the initiation of drag events to specific child handle elements.
- Drag-and-Drop Cloning - Implements functionality to duplicate an element upon dragging so the original remains in place.
- Workspace Interface Organizers - Allows users to organize their workspace by dragging components into containers with real-time previews.
- Interaction and Gestures - Simplified drag-and-drop functionality.
- UI Frameworks - Drag-and-drop library with jQuery support.
- User Interface Components - Simplifies drag and drop functionality implementation.
