atlassian/pragmatic-drag-and-drop
Pragmatic Drag And Drop
Pragmatic Drag and Drop is a TypeScript library that provides a complete system for implementing drag and drop interactions in web applications. It handles the full lifecycle of drag operations, from registering drop targets and monitoring drag events to managing cleanup functions, all through a structured adapter-based approach.
The library supports a wide range of data manipulation patterns, including reordering items within lists, tables, trees, virtual lists, and side navigation, as well as moving items between lists and across columns in a board layout. It also enables swapping items in a grid, resizing elements, accepting files dropped from the operating system, and transferring data across browser windows or iframes.
Additional capabilities include utilities for reordering arrays based on drag position changes and combining multiple cleanup functions into a single call for easier teardown. The library is designed to work with HTML elements, text selections, and external content through dedicated adapters.
Features
- Drag Adapters - Provides dedicated adapters for dragging HTML elements, text selections, and external content.
- UI List Reordering - Provides a mechanism for reordering items within a single list via drag-and-drop.
- Drag Lifecycle Events - Listens for drag operation events to react to start, move, and end phases.
- Drop Target Registries - Provides a system for marking elements as valid drop zones during drag operations.
- Multi-List Item Transfer - Ships a complete system for transferring items between lists via drag-and-drop.
- Drag and Resize Functionality - Provides functionality for resizing elements by dragging their edges or corners.
- Tree Node Reorderers - Provides utilities for rearranging nodes in hierarchical tree structures via drag-and-drop.
- Drag-and-Drop Row Reorderers - Ships a component for rearranging table rows via drag-and-drop interactions.
- Reorderable Virtual Lists - Supports reordering items within a virtualized list via drag-and-drop.
- Drag-and-Drop File Upload - Provides a dedicated adapter for capturing files dragged from the operating system.
- Data Transfer Mechanisms - Shares drag data between browser tabs, iframes, or native applications during a drag operation.
- Grid Item Swapping - Enables swapping items in a grid layout via drag-and-drop.
- Kanban Boards - Supports moving items between columns on a kanban-style board via drag-and-drop.
- Sidebar Navigation Organization - Enables drag-and-drop reordering of navigation items within a sidebar.
