Fork me on GitHub

iOS UICollectionView Cell拖拽重排的实现



写在前面

最近公司准备做一个类似支付宝UICollectionViewCell拖拽重排的功能,UICollectionViewCell的任意拖拽排列,支付宝最新的版本已去掉了任意拖拽功能,而只是对常用功能进行拖拽重排,没有出现超出屏幕的情况。个人感觉应该更好,毕竟太多功能去拖拽重排对用户来说是一个特别大的工作量,只需把常用功能提即可。相应的功能点还是在对应的分组里,至于我们的需求暂时不怎么清楚,使用还是研究下任意拖拽吧。

未来计划

  • [ ] Demo及文档完善。
  • [ ] 支付宝拖拽效果实现。

  • [x] 今日头条频道拖拽重排效果实现。

  • [ ] 看荐拖拽重排效果实现及优化。ps:看荐的拖拽重排发现一个bug,哈哈。

效果图

效果1

效果2

效果3

效果4

基本实现了头条的频道重排功能,额外增加了当拖拽到边沿时自动滚动的功能。

视频演示

在线视频演示

须知

BMDragCellCollectionView 基于 Xcode 8.2.1 , iOS 6+ ARC,请使用最新正式版来编译BMDragCellCollectionView,旧版本的Xcode有效,但不保证会出现一些兼容性问题。

开源不易,来个star鼓励下吧

Demo运行

老提不要说不会 Cocoapods

  1. cd BMDragCellCollectionView/BMDragCellCollectionViewDemo

  2. pod install

  3. open BMDragCellCollectionViewDemo.xcworkspace

集成

CocoaPods

推荐使用 CocoaPods 安装。

  1. Podfile 中添加 pod 'BMDragCellCollectionView', '1.0.3'
  2. 执行 pod installpod update
  3. 使用的地方导入 "BMDragCellCollectionView.h"
  4. 如果无法找到 BMDragCellCollectionView可用 pod setuprm ~/Library/Caches/CocoaPods/search_index.jsonpod search BMDragCellCollectionView

手动安装

  1. 通过 Clone 或者 download 下载BMDragCellCollectionView 文件夹内的所有内容。
  2. 将 BMDragCellCollectionView 内的源文件添加(拖放)到你的工程。
  3. 导入 "BMDragCellCollectionView.h"

基本使用

  • 在需要使用长按拖拽UICollectionView的地方使用BMDragCellCollectionView代替,用法和UICollectionView一样。
1
2
3
4
5
UICollectionViewFlowLayout *layout = [[UICollectionViewFlowLayout alloc] init];
BMDragCellCollectionView *collectionView = [[BMDragCellCollectionView alloc] initWithFrame:CGRectMake(0, 0, WIDTH, HEIGHT) collectionViewLayout:layout];
collectionView.delegate = self;
collectionView.dataSource = self;
[self.view addSubview:collectionView];
  • 实现 BMDragCollectionViewDataSource协议的如下方法

此协议用于在交换时获取数据源,内部做数据源操作。

1
2
3
- (NSArray *)dataSourceWithDragCellCollectionView:(BMDragCellCollectionView *)dragCellCollectionView {
return self.dataSource;
}
  • 实现 BMDragCellCollectionViewDelegate协议的如下方法

此协议用于在在内部处理好数据源时通知使用者更新数据源。

1
2
3
- (void)dragCellCollectionView:(BMDragCellCollectionView *)dragCellCollectionView newDataArrayAfterMove:(NSArray *)newDataArray {
self.dataSource = [newDataArray mutableCopy];
}

BMDragCellCollectionView属性及方法说明

长按触发时间,默认是0.5秒,建议根据实际情况设值

1
@property (nonatomic, assign) NSTimeInterval minimumPressDuration;

是否可以拖拽 默认为YES

1
@property (nonatomic, assign, getter=isCanDrag) BOOL canDrag;

长按拖拽时Cell缩放比例 默认是:1.2

1
@property (nonatomic, assign) CGFloat dragZoomScale;

拖拽的Cell在拖拽移动时的透明度 默认是: 1.0

1
@property (assign, nonatomic) CGFloat dragCellAlpha;

代理方法

当一个Cell将要开始拖拽时调用询问是否可以拖拽, YES: 可以, NO: 不可以,默认是YES

1
- (BOOL)dragCellCollectionViewShouldBeginMove:(BMDragCellCollectionView *)dragCellCollectionView indexPath:(NSIndexPath *)indexPath;

当将要交换时,询问是否可以交换时调用询问是否可以交换, YES: 可以, NO: 不可以,默认是YES

1
- (BOOL)dragCellCollectionViewShouldBeginExchange:(BMDragCellCollectionView *)dragCellCollectionView sourceIndexPath:(NSIndexPath *)sourceIndexPath toIndexPath:(NSIndexPath *)destinationIndexPath;

完成重排时,重排成成功时

1
- (void)dragCellCollectionViewDidEndDrag:(BMDragCellCollectionView *)dragCellCollectionView;

下面的三个方法在手势拖拽变化时调用,开始拖拽 正在拖拽 结束拖拽

1
2
3
4
5
- (void)dragCellCollectionView:(BMDragCellCollectionView *)dragCellCollectionView beganDragAtPoint:(CGPoint)point   indexPath:(NSIndexPath *)indexPath;

- (void)dragCellCollectionView:(BMDragCellCollectionView *)dragCellCollectionView changedDragAtPoint:(CGPoint)point indexPath:(NSIndexPath *)indexPath;

- (void)dragCellCollectionView:(BMDragCellCollectionView *)dragCellCollectionView endedDragAtPoint:(CGPoint)point indexPath:(NSIndexPath *)indexPath;

期待

  • 如果在使用过程中遇到BUG,希望您能Issues我。
- END -
关注微信公众号,发现更多精彩

文章作者:梁大红

特别声明:若无特殊声明均为原创,转载请注明,侵权请联系

版权声明:署名-非商业性使用-禁止演绎 4.0 国际