EasyPull 3.0.0

EasyPull 3.0.0

TestsTested
LangLanguage SwiftSwift
License MIT
ReleasedLast Release Oct 2016
SPMSupports SPM

Maintained by ronghao.



EasyPull 3.0.0

  • By
  • RongHao

EasyPull

Let pull-to-refresh Easy for any UIScrollView in Swift

You have the flexibility to set custom view with fantastic animation.(可以灵活的设置自定义效果,实现期望的动画)


Usage

(see sample Xcode project in /Demo)

Adding Drop Pull to Refresh (添加下拉刷新)

Only support Manual Mode(仅支持手动模式)

 tableView.easy.addDropPull(with: {
     // prepend data to dataSource, insert cells at top of table view
     // call tableView.easy.stopDropPull() when done
 })

Note: You can trigger drop-excuting directly using this method. (用下面这个方法,你可以直接触发下拉刷新操作)

 func triggerDropExcuting()

Adding Up Pull to Refresh and Load more (添加上拉加载)

Manual Mode(手动模式)

 tableView.easy.addUpPullManual(with: {
     // prepend data to dataSource, insert cells at bottom of table view
     // call tableView.easy.stopUpPull() when done
 })

Automatic Mode(自动模式)

 tableView.easy.addUpPullAutomatic(with: {
     // prepend data to dataSource, insert cells at bottom of table view
     // call tableView.easy.stopUpPull() when done
 })

Note: You can enable/unable Up-Pull using this method. Suitable for scenes without more data (用下面这个方法,你可以启用/禁止上拉加载,适用于没有更多数据的场景)

 func enableUpPull()
 func unableUpPull()

Customization (自定义)

The pull-to-refresh view can be customized using the following methods:

 func addDropPull(with action: (() ->Void), customDropView: EasyViewManual? = nil)
 func addUpPullManual(with action: (() ->Void), customUpView: EasyViewManual? = nil)
 func addUpPullAutomatic(with action: (() ->Void), customUpView: EasyViewAutomatic? = nil)

NOTE: Your custom views must implement the EasyViewManual protocol when you prefer the Manual mode

Or implement the EasyViewAutomatic protocol when you prefer the Automatic mode.

(如果需要手动模式,你的自定义view必须实现EasyViewManual协议。如果需要自动模式,你的自定义view则必须实现EasyViewAutomatic协议。)

(see sample Xcode project in /Demo/MyCusyomView.swift or /Demo/EasyPull/DefaultView.swift)

Note (注意)

释放所有的Action,避免循环引用cycle retain。

 func releaseAll()

当App要离开某一个使用了EasyPull的viewController时,记得releaseAll哦

Requirements

  • iOS 8.0+
  • Swift 3.0 (EasyPull 3.x), Swift 2.x (EasyPull 1.x)

The main development of EasyPull is based on Swift 3.

Installation

Source files

Alternatively you can directly add the /EasyPull/EasyPull source files to your project.

License

This code is distributed under the terms and conditions of the MIT license.