tableviewdragger

Description

UITableViewDragger is a lightweight library for simplifying the implementation of drag-and-drop functionality in UITableViews on iOS. With this library, you can easily enable drag-and-drop reordering of table view cells, providing a smooth and intuitive user experience.

Installation

To integrate the UITableViewDragger library into your Xcode project, you can use either CocoaPods or manually include the required files.

CocoaPods

1. Add the following line to your Podfile:

pod 'TableViewDragger'

2. Run pod install in your terminal.
3. Import the library in your code:

import UITableViewDragger

Manual

1. Download the latest release from the GitHub repository: example/TableViewDragger
2. Drag and drop the necessary files into your Xcode project.
3. Import the library in your code:

import UITableViewDragger

Features

• Drag-and-drop reordering of table view cells.
• Smooth and performant animations during dragging and reordering.
• Support for long press gesture recognition to initiate dragging.
• Customizable drag handle appearance.
• Delegate methods for fine-grained control over the dragging process.
• Ability to enable or disable dragging for specific cells individually.
• Handling of edge scrolling during dragging for easy reordering of cells outside the visible area.
• Support for both UITableView and UICollectionView.

Usage

To use UITableViewDragger in your project, follow the steps below:

1. Create an instance of UITableViewDragger with your table view:

let dragger = UITableViewDragger(tableView: yourTableView)

2. Implement the necessary delegate methods in your view controller:

// Conform to UITableViewDelegateDraggerDelegate
extension YourViewController: UITableViewDelegateDraggerDelegate {
    // Implement required delegate methods
    func dragger(_ dragger: UITableViewDragger, dataForDraggingAt indexPath: IndexPath) -> UIDragItem {
        // Provide the necessary data to be transferred when dragging begins
        // Create and return a UIDragItem object
    }
    
    func dragger(_ dragger: UITableViewDragger, moveDraggedRowAt sourceIndexPath: IndexPath, to destinationIndexPath: IndexPath) {
        // Perform the necessary updates to your data model when a cell is dropped in a new position
    }
    
    // Optional delegate methods for further customization
    // ...
}

// Assign your view controller as the delegate
dragger.delegate = self
    

3. Customize the drag handle appearance (optional):

dragger.dragHandleStyle = .custom(yourCustomDragHandleView)

4. Enable or disable dragging for specific cells (optional):

dragger.canDragCellAt = { indexPath in
    // Return true or false depending on whether the cell at the given indexPath should be draggable
    return ...
}

5. Enjoy drag-and-drop reordering of your table view cells!

Conclusion

With UITableViewDragger, implementing drag-and-drop functionality in your UITableView-based app becomes a breeze. Take advantage of smooth animations, delegate methods, and customizability to provide a seamless user experience while allowing users to efficiently reorder their data.