优雅的长按Cell移动 DHMovableExtension

DHMovableExtension

优雅的长按Cell移动，针对UITableView与UICollectionView的Cell长按移动。

• 耦合低，代码侵入性低
• 支持分组移动
• 可定制化移动，设置不可移动或不可交换的位置
• 极易使用

安装

pod 'DHMovableExtension'

• 当前版本：1.0.2

使用方式

1. 引用头文件

#import "UIScrollView+DHMovableExtension.h"

2. 配置UITableView/UICollectionView必要参数

self.tableView.movable = YES;	// 必要开关
self.tableView.movableDataSource = self;	// 数据源获取代理

3. 实现数据源（DHMovableDataSource详细说明）

>> 其中self.data为UITableView/UICollectionView的数据数组
- (NSArray *)movable_dataSource:(UIScrollView *)scrollView {
    return [self.data copy];
}

- (void)movable_scrollView:(UIScrollView *)scrollView dataSourceExchanged:(NSArray *)dataSource {
  	// 将重排后的数据重新赋值
    self.dataSource = [data copy];
}

参数说明

• edgeScrollEnable: 边缘滚动使能。当跟随手指的截图cell移动到屏幕边缘时，触发引起UIScrollView是否能跟着滚动
• edgeScrollInsets: 边缘触发距离，四个方向与边缘距离达到此值将触发UIScrollView滚动。默认为UIEdgeInsetsZero
• minimumResponseDuration: 最小响应手势。长按反应时长
• movableCellAnimationDuration: 动画时长。当长按生效后，cell中心点移动到手指的位置的动画时长
• drawMovableCellBlock: 绘制cell截图样式Block。参数是截图后的视图，即UIImageView，旨在修改样式，以区分静态的cell。其中此优先级最高，其次代理方法-movable_scrollView:drawMovableCell:。如若此block与代理方法都没有实现，将使用默认截图样式
• exchangeDataSourceBlock: 交换数据源，切勿期间刷新数据

DHMovableDataSource说明

注意：切勿在有关方法中调用UITableView/UICollectionView的刷新数据（如-reloadData）方法。因为此代理响应期间正处于手势Change状态，刷新数据状况将不可控。

默认交换数据方法（注意：如使用，必须两个方法同时实现）

提供两种数据数组的交换方式：

• 一种元素为非数组，例如：@[@"1", @"2"]
• 一种元素为数组，例如：@[@[@"0-0", @"0-1"], @[@"1-0"]]

/** UITableView/UICollectionView数据数组 -- 交换前 */
- (NSArray *)movable_dataSource:(UIScrollView *)scrollView;
/** 交换后数据反馈 -- 一般操作为重新复制给 原数据对象 */
- (void)movable_scrollView:(UIScrollView *)scrollView dataSourceExchanged:(NSArray *)dataSource;

自定义交换数据方法

/// 如设置此变量，将优先只用此block进行交换数据，不用movableDataSource代理
@property (nonatomic, copy) void(^exchangeDataSourceBlock) (NSIndexPath *from, NSIndexPath *to);
/// 效果同exchangeDataSourceBlock
- (void)movable_scrollView:(UIScrollView *)scrollView exchangeDataSourceAtIndexPath:(NSIndexPath *)from to:(NSIndexPath *)to;

DHMovableDelegate 说明

/** 判断两个位置的cell是否可以替换 */
- (BOOL)movable_scrollView:(UIScrollView *)scrollView isCellExchangeableFromIndexPath:(NSIndexPath *)fromIndexPath toIndexPath:(NSIndexPath *)toIndexPath;

/** 判断某个IndexPath的cell是否可以移动 */
- (BOOL)movable_scrollView:(UIScrollView *)scrollView isCellMovableAtIndexPath:(NSIndexPath *)indexPath;

/**
 cell将要开始移动
 
 @param movableCell 移动的cell截图
 @param indexPath 起始位置
 */
- (void)movable_scrollView:(UIScrollView *)scrollView movableCell:(UIView *)movableCell willMoveFromIndexPath:(NSIndexPath *)indexPath;

/** 完成一次cell从from到to的移动 */
- (void)movable_scrollView:(UIScrollView *)scrollView cellDidMovedFromIndexPath:(NSIndexPath *)fromIndexPath toIndexPath:(NSIndexPath *)toIndexPath;

/**
 截图正在移动
 
 @param movableCell 移动的cell截图
 */
- (void)movable_scrollView:(UIScrollView *)scrollView movableCellIsMoving:(UIView *)movableCell;

/**
 结束移动
 
 @param movableCell 移动的cell截图
 @param indexPath 终止位置
 */
- (void)movable_scrollView:(UIScrollView *)scrollView movableCell:(UIView *)movableCell didEndMovedAtIndexPath:(NSIndexPath *)indexPath;

/**
 绘制可移动的cell截图，给已经截图的cell添加样式
 
 @param movableCell 移动的cell截图
 */
- (void)movable_scrollView:(UIScrollView *)scrollView drawMovableCell:(UIView *)movableCell;

效果图

DHMovableExtensionDemo