SurfingRefreshControl

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #typescript #go #android #machine-learning #rust #docker #java #awesome #cli #awesome-list #mcp

SurfingRefreshControl

(★ 55)

Customizable pull-to-refresh control,written in pure Swift.

File Explorer

Download Latest Version (.zip)

- - polygon.plist
  - square.plist
  - storehouserefresh.plist
  - surfing.plist
- SurfingBarItem.swift
- SurfingRefreshControl.swift
- - AppDelegate.swift
  - DemoViewController.swift
  - Info.plist
  - surfing.jpg
- - project.pbxproj
LICENSE
README.md
SurfingRefreshControl.podspec

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# What is it

This project is heavily inspired by [CBStoreHouseRefreshControl](https://github.com/coolbeet/CBStoreHouseRefreshControl) which is Objective-C implemented. SurfingRefreshControl provides you a chance to use pure Swift alternative in your next app.

You can customize any desired shape through `plist` file like below two shapes:

![alt tag](http://peiweichen.github.io/outofwebsite/gif/surfing.gif)

![alt tag](http://peiweichen.github.io/outofwebsite/gif/storehouse.gif)

# How to use

### Warning:Check out demo app directly if you're too lazy to read

You can attach it to any `UIScrollView`  ( like `UITableView` `UICollectionView`) :

```swift
class func attachToScrollView(
scrollView:UIScrollView,
target:AnyObject,
refreshAction:Selector,
plist:String,
color:UIColor=UIColor.blackColor(),
lineWidth:CGFloat=2,
dropHeight:CGFloat=80,
scale:CGFloat=1,
horizontalRandomness:Int=150,
reverseLoadingAnimation:Bool=false,
internalAnimationFactor:CGFloat=1.0) -> SurfingRefreshControl
```

For instance:

```swift
self.surfingRefreshControl = SurfingRefreshControl.attachToScrollView(tableView, target: self,refreshAction:#selector(DemoViewController.refreshTriggered), plist: "surfing", color: UIColor.whiteColor(),lineWidth: 1.5, dropHeight: 120, scale: 1.0, horizontalRandomness: 100,  reverseLoadingAnimation: false, internalAnimationFactor: 0.8) 
```

Implement `UIScrollViewDelegate` in your `UIViewController` to notify SurfingRefreshControl your scrollView's movements:

```swift
override func scrollViewDidScroll(scrollView: UIScrollView) {
  	self.surfingRefreshControl.scrollViewDidScroll(scrollView)
}

override func scrollViewDidEndDragging(scrollView: UIScrollView, willDecelerate decelerate: Bool) {
	self.surfingRefreshControl.scrollViewDidEndDragging(scrollView, willDecelerate: decelerate)
}
```

When you're done with surfing,simply call

```swift
self.surfingRefreshControl.finishLoading()
```

# How to customize your refresh:

SurfingRefreshControl make use of `SurfingBarItem` which actually is a UIView subclass, made of start point and end point to form a line.Imagine a squre need 4 line,thus need 4 SurfingBarItem,which equal to 4 start points and 4 end points.In conclusion,a square surfing refresh control would need a plist file of 4 start points and 4 end points,as shown below:

![alt tag](http://peiweichen.github.io/outofwebsite/images/squareplist.png)

Square SurfingRefreshControl output is:

![alt tag](http://peiweichen.github.io/outofwebsite/images/squarerefresh.png)

[PaintCode](http://www.paintcodeapp.com/) to generate your startpoints and endpoints without too much hassle:

![alt tag](http://peiweichen.github.io/outofwebsite/images/paintcodedemo.png)

Author
------
Peiwei Chen 
peiwei233@gmail.com  
[Blog](http://peiweichen.github.io)

License
-------
Copyright (c) 2016 Peiwei Chen <peiwei233@gmail.com>. See the LICENSE file for license rights and limitations (MIT).

SurfingRefreshControl

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

SurfingRefreshControl

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README