Skip to content

Latest commit

 

History

History
121 lines (99 loc) · 5.5 KB

README.md

File metadata and controls

121 lines (99 loc) · 5.5 KB
Raw

在iOS中下拉刷新和上拉加载更多组件（太长，下面就叫它pullToRefresh 组件了）使用的非常普遍。开源社区也有非常丰富的资源让你能够轻松的实现这个效果。观察各优秀app你会发现他们的pullToRefresh 组件都有自己的特色。如何才能快速的创建出私人定制版pullToRefresh 组件？ 也许你能从我的开源项目HERefresh中获得一些灵感。

####HERefresh完成什么样的工作？ HERefresh是一个类簇。它维护着一个状态机，能过通过监听UIScrollView的contentOffset属性确定当前pullToRefresh组件应该切换到什么状态(说的简单，实现时考虑的东西还是挺多的)。然后根据具体状态对UI进行相应操作（通过调用HERefreshView的 func refresh(_ refresh:HERefresh,stateChangedTo state:HERefreshState) 进行UI的修改）。

//状态
public enum HERefreshState: Equatable, CustomStringConvertible {
    case initial                    // 初始话
    case pulling(progress: Float)   // 下/上拉进度（0~1）
    case loading                    // 正在加载数据
    case finished                   // 加载结束
    case noMoreData                 // 没有更多数据（只在footer中有效）
}


//initial:   初始化操作。 例如调整contentInsert 从而隐藏 header（有动画）;添加动画（动画进度可通过手势进行控制）；
//pulling(progress: Float) :  下/上拉进度（0~1）你可以根据process值进行一些控制，例如动画执行的offset。  在process<1时松手，状态切换到initial， process>1时松手状态切换到loading。
//loading :  正在加载状态，此时不会响应下/上拉操作了，知道加载结束。
//finished:  当前切换到此状态时，refreshView并不会隐藏。在此状态时可以执行一些结束动画，结束动画执行结束后你再去将状态改为initial，此时refreshView会隐藏起来。这样子定制更加灵活。结束动画需要在HERefreshView的 func refresh(_ refresh:HERefresh,stateChangedTo state:HERefreshState)中进行定制。

####你需要做什么？ 1， 创建一个继承自HERefreshView的类， 并根据状态修改UI或执行动画。

class HERefreshView: UIView,HERefreshDelegate {
	 func refresh(_ refresh: HERefresh, stateChangedTo state: HERefreshState){
		 assert(false, "You must override \(#function)")
	 }
}
protocol HERefreshDelegate:NSObjectProtocol {
    func refresh(_ refresh:HERefresh,stateChangedTo state:HERefreshState)
}

class HERefreshDefaultHeaderView: HERefreshView {
    //创建UI ...
    //相应状态变换    
   override func refresh(_ refresh:HERefresh,stateChangedTo state:HERefreshState){
                //do  something
    }
}

2，创建refreshView，指定refreshView的size。 创建 HERefreshHeader或者HERefreshFooter对象（HERefreshHeader用于下拉刷新，HERefreshFooter用于上拉加载更多）。

let frame = CGRect(x: 0, y: 0, width: UIScreen.main.bounds.width, height: 40)
let defaultHeaderView = HERefreshHeaderView(frame: frame)

3， 将HERefreshHeader添加到scrollView 上

self.tableView.addRefreshHeader(pullToMakeSoupHeader) {
// block，会在进入loading 状态是进行回调。
 }

实现效果

####header-pullToMakeSoup 创意来自PullToRefresh。 我在demo中演示了如何使用HERefresh 来实现这个效果。动画的实现原理参考这里。

pullToMakeSoup

header-default

header-default

self.tableView.addDefaultHeader {
            //加载时进行回调， 模拟延时
            let delayTime = DispatchTime.now() + Double(Int64(3 * Double(NSEC_PER_SEC))) / Double(NSEC_PER_SEC)
            DispatchQueue.main.asyncAfter(deadline: delayTime) {
                self.data = 5
                self.tableView.reloadData()
                self.tableView.endRefreshHeader()
                self.tableView.canLoadMoreData(true)
            }
        }

####footer-default folder-default完成上拉加载更多的功能。使用也是很简单，一句话：

self.tableView.addDefaultFooter {
   //模拟延时
   let delayTime = DispatchTime.now() + Double(Int64(3 * Double(NSEC_PER_SEC))) / Double(NSEC_PER_SEC)
   DispatchQueue.main.asyncAfter(deadline: delayTime) {
       self.data+=5
       self.tableView.reloadData()
       self.tableView.endRefreshFooter()
   }
}

通过配置属性实现不同的行为：

1， canAutoLoadMore

    ///自动加载更多。
    ///false:  上拉一定距离，松手后才会进行加载
    ///true:   当scrollView滑动到底部时就自动调用action块(默认值)
    var canAutoLoadMore = true

2， befordDistance

///当canAutoLoadMore = true时，在scrollView距离底部有一定距离时就开始提前加载。简书就有这样的效果。
var befordDistance:CGFloat = 0

3， isHiddenWhenNoMoreData

///没有更多数据时，是否隐藏refreshView。
var isHiddenWhenNoMoreData = false

//不隐藏 不隐藏