Skip to content

iOS UICollectionView UICollectionViewCell long press to drag the reorder framework(支付宝我的应用编辑,今日头条我的频道编辑)

Notifications You must be signed in to change notification settings

MarkLifes/BMDragCellCollectionView

 
 

Repository files navigation

Version Support GitHub stars


写在前面

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

同款的Swift版本

声明

此库在https://github.com/wazrx/XWDragCellCollectionView的基础上进行了一系列优化及丰富API,向前人致敬。

未来计划

  • Swift版本
  • Demo及文档完善。
  • 支付宝拖拽效果实现,资源来源于http://www.iconfont.cn/感谢。
  • 今日头条频道拖拽重排效果实现。
  • 腾讯新闻频道拖拽重排效果实现。
  • 看荐拖拽重排效果实现及优化。ps:看荐的拖拽重排发现一个bug,哈哈。
  • 您认为有必要的也@我哈.

效果图

视频演示

在线视频演示

须知

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

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

集成

  • 支持 CocoaPods 强力推荐
  • 手动安装

基本使用

  • 在需要使用长按拖拽UICollectionView 的地方使用BMDragCellCollectionView代替,用法和UICollectionView一样。
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协议的如下方法

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

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

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

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

BMDragCellCollectionView属性及方法说明

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

@property (nonatomic, assign) NSTimeInterval minimumPressDuration;

是否可以拖拽 默认为YES

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

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

@property (nonatomic, assign) CGFloat dragZoomScale;

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

@property (assign, nonatomic) CGFloat dragCellAlpha;

使用者想移动到指定位置操作时

- (void)dragMoveItemToIndexPath:(NSIndexPath *)indexPath;

代理方法

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

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

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

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

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

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

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

- (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;

结束拖拽时时是否内部自动处理,在一些需要特殊需求时可以在此方法做,如:今日头条当第一组拖拽到第二组((默认是不交换处理的)松手时需要自动把此Cell移动到第二组中的同步或者尾部。那可在此方法 返回NO,同时调用 - (void)dragMoveItemToIndexPath:(NSIndexPath *)indexPath;方法完成移动

- (BOOL)dragCellCollectionView:(BMDragCellCollectionView *)dragCellCollectionView endedDragAutomaticOperationAtPoint:(CGPoint)point section:(NSInteger)section indexPath:(NSIndexPath *)indexPath;

期待

版本

  • v2.0.2
  • v2.0.1
  • v2.0.0

MIT

About

iOS UICollectionView UICollectionViewCell long press to drag the reorder framework(支付宝我的应用编辑,今日头条我的频道编辑)

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Objective-C 99.4%
  • Ruby 0.6%