basecamp/LXReorderableCollectionViewFlowLayout

Name: LXReorderableCollectionViewFlowLayout

Owner: Basecamp

Description: Extends `UICollectionViewFlowLayout` to support reordering of cells. Similar to long press and pan on books in iBook.

Created: 2014-01-08 17:26:37.0

Updated: 2017-06-15 19:53:22.0

Pushed: 2017-06-15 19:53:20.0

Homepage: http://lxcid.com/

Size: 223

Language: Objective-C

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

LXReorderableCollectionViewFlowLayout

Extends UICollectionViewFlowLayout to support reordering of cells. Similar to long press and pan on books in iBook.

Features

The goal of LXReorderableCollectionViewFlowLayout is to provides capability for reordering of cell, similar to iBook.

• Long press on cell to invoke reordering capability.
• When reordering capability is invoked, fade the selected cell from highlighted to normal state.
• Drag around the selected cell to move it to the desired location, the other cells adjust accordingly. Callback in the form of delegate methods are invoked.
• Drag selected cell to the edges, depending on scroll direction, scroll in the desired direction.
• Release to stop reordering.

Getting Started

1. Install using CocoaPods or drag the LXReorderableCollectionViewFlowLayout folder into your project.

2. Initialize/Setup your collection view to use LXReorderableCollectionViewFlowLayout.

3. The collection view controller that is to support reordering capability must conforms to LXReorderableCollectionViewDataSource protocol. For example,

   - (void)collectionView:(UICollectionView *)collectionView itemAtIndexPath:(NSIndexPath *)fromIndexPath willMoveToIndexPath:(NSIndexPath *)toIndexPath {
       id object = [mutableArray objectAtIndex:fromIndexPath.item];
       [mutableArray removeObjectAtIndex:fromIndexPath.item];
       [mutableArray insertObject:object atIndex:toIndexPath.item];
   }
   

4. You can listen to some dragging events through comforming to LXReorderableCollectionViewDelegateFlowLayout methods.

5. Setup your collection view accordingly to your need, run and see it in action! :D

Changes

Feb 24 2013 (Luke Scott)

• Removed setUpGestureRecognizersOnCollectionView
• Removed layout from delegate methods (can be accessed from collectionView)
• Renamed delegate methods and split between dataSource and delegate
• Added dataSource and delegate examples to sample project

Feb 23 2013 (Luke Scott)

• Refactored everything to be more readable / maintainable
• Deprecated setUpGestureRecognizersOnCollectionView - no longer necessary

Requirements

• ARC
• iOS 6 and above preferred
• Xcode 4.5 and above

Credits

• Originally created by Stan Chang Khin Boon (Github: @lxcid, Twitter: @lxcid, Google+: +Stan Chang Khin Boon) for buUuk, with reference to MaximilianL's implementation on Apple Developer Forums.
• Refactored by Luke Scott, with some help from mulle-nat's fork.
• Playing cards in the demo are downloaded from http://www.jfitz.com/cards/.

Alternatives

• DraggableCollectionView by Luke Scott.

License

LXReorderableCollectionViewFlowLayout is available under the MIT license.