Skip to content
Pull to refresh in Swift
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
PullToRefresh.xcodeproj
PullToRefreshDemo
Refresher
RefresherTests
previews
.gitignore
.swift-version
.travis.yml
LICENSE
README.md
Refresher.podspec
refresher.png

README.md

Build Status

Refresher is pull to refresh library written in Swift. It provides easy to use UIScrollView methods to add pull to refresh to your view. Refresher also supports custom animations.

Usage

Basic usage

tableView.addPullToRefreshWithAction {
	NSOperationQueue().addOperationWithBlock {
    	sleep(2)
        NSOperationQueue.mainQueue().addOperationWithBlock {
        	self.tableView.stopPullToRefresh()
        }
    }
}

Custom animations

Refresher supports custom animations on PullToRefreshView. You need to create object that conforms to PullToRefreshViewAnimator protocol. Then, just pass your custom animator in addPullToRefrshWithAction:

tableView.addPullToRefreshWithAction({           
  	NSOperationQueue().addOperationWithBlock {
   		sleep(2)
        NSOperationQueue.mainQueue().addOperationWithBlock {
        	self.tableView.stopPullToRefresh()
        }
    }
}, withAnimator: CustomAnimator())

Required methods that your custom object need to implement are:

  • func pullToRefreshAnimationDidStart(view: PullToRefreshView)- Called when user releases finger and when loading actually starts. Start your animations here.
  • func pullToRefreshAnimationDidEnd(view: PullToRefreshView) - Called when animation is over. Perform any necessary after animation cleanup here.
  • func pullToRefresh(view: PullToRefreshView, progressDidChange progress: CGFloat) - Called while user is pulling scroll view. Useful if you want to implement some kind of progress like behaviour.
  • func pullToRefresh(view: PullToRefreshView, stateDidChange state: PullToRefreshViewState) - Called when PullToRefreshView changes its state

Custom views

You can use your own custom UIView subclass as pull to refresh view.

if let customSubview = NSBundle.mainBundle().loadNibNamed("CustomSubview", owner: self, options: nil).first as? CustomSubview {
	tableView.addPullToRefreshWithAction({
		NSOperationQueue().addOperationWithBlock {
			sleep(2)
			NSOperationQueue.mainQueue().addOperationWithBlock {
				self.tableView.stopPullToRefresh()
			}
		}
	}, withAnimator: customSubview)
}

Your custom subclass has to conform to PullToRefreshViewDelegate.

Requirements

  • Xcode 6
  • iOS 8.0

Installation

Git submodule

  1. Add Refresher as a git submodule into your top-level project directory or simply copy whole folder
  2. Find PullToRefresh.xcodeproj and drag it into the file navigator of your app project.
  3. In Xcode, navigate to the target configuration window by clicking on the blue project icon, and selecting the application target under the "Targets" heading in the sidebar.
  4. Under "General" panel go to "Linked Frameworks and Libraries" and add Refresher.framework

Framework

  1. Simply download Refresher
  2. Build it and you should find Refresher.framework under "Products" group.
  3. Right click on it and select "Show in Finder" option.
  4. Just drag and drop Refresher.framework to your project

Cocoapods

  1. Add pod 'Refresher' to your Podfile
  2. Run pod install

Examples

Refresher: preview default Refresher: preview beat Refresher: preview pacman

Credits

Refresher is created by Josip Ćavar and inspired by SVPullToRefresh. If you have suggestions or bug reports, feel free to send pull request or create new issue.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.