Swiftpack.co -  SimformSolutionsPvtLtd/SSCustomPullToRefresh as Swift Package
Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
SimformSolutionsPvtLtd/SSCustomPullToRefresh
SSCustomPullToRefresh is an open-source library that uses UIKit to add an animation to the pull to refresh view in a UITableView and UICollectionView.
.package(url: "https://github.com/SimformSolutionsPvtLtd/SSCustomPullToRefresh.git", from: "1.0.1")

SSCustomPullToRefresh

SSCustomPullToRefresh is an open-source library that uses UIKit to add an animation to the pull to refresh view in a UITableView and UICollectionView.

Swift Version License Carthage Compatible SwiftPM Compatible Platform PRs Welcome

Animation Type

Spinner Animation Pulse Animation Wave Animation Wave Animation
Alt text Alt text Alt text Alt text

Requirements

  • iOS 10.0+
  • Xcode 11+

Installation

CocoaPods

  • You can use CocoaPods to install SSCustomPullToRefresh by adding it to your Podfile:

     use_frameworks!
     pod 'SSCustomPullToRefresh'
    
  • import SSCustomPullToRefresh

Manually

  • Download and drop SSCustomPullToRefresh folder in your project.
  • Congratulations!

Swift Package Manager

  • When using Xcode 11 or later, you can install SSCustomPullToRefresh by going to your Project settings > Swift Packages and add the repository by providing the GitHub URL. Alternatively, you can go to File > Swift Packages > Add Package Dependencies...
dependencies: [
    .package(url: "https://github.com/mobile-simformsolutions/SSCustomPullToRefresh.git", from: "1.0.1")
]

Carthage

  • Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. You can install Carthage with Homebrew using the following command:
$ brew update
$ brew install carthage

To integrate SSCustomPullToRefresh into your Xcode project using Carthage, add the following line to your Cartfile:

github "mobile-simformsolutions/SSCustomPullToRefresh"

Run carthage to build and drag the SSCustomPullToRefresh(Sources/SSCustomPullToRefresh) into your Xcode project.

How It Works

  • You can use it for any component having a base class as ScrollView like TableView or CollectionView.

1. Spinner Animation

  • SpinnerAnimationView takes image and backgroundColor as an input parameter. You can provide it as per your choice.

    spinnerAnnimation = SpinnerAnimationView(image: UIImage(named: "spinner"), backgroundColor: .purple)           
    spinnerAnnimation.delegate = self   
    spinnerAnnimation.parentView = self.tableView    
    spinnerAnnimation.setupRefreshControl()
    

2. Wave Animation

  • SineWaveAnimationView takes Color as an input parameter.

    sineAnnimation = SineWaveAnimationView(color: .purple)           
    sineAnnimation.delegate = self 
    sineAnnimation.parentView = self.tableView
    sineAnnimation.setupRefreshControl()
    
  • Along with this, you can also provide two different colors and a waveHeight value. You can give a waveHeight value between 5.0 to 50.0.

    sineAnnimation = SineWaveAnimationView(frontColor: .orange, backColor: .purple, waveHeight: 10.0)           
    

3. Pulse Animation

  • PulseAnimationView takes Color as an input parameter. You can provide center circle color, pulse color and background color of your refresh view.

    pulseAnnimation = PulseAnimationView(circleColor: .purple, pulseColor: .purple, 
                                                               pulseViewBackgroundColor: .brown)
    pulseAnnimation.delegate = self   
    pulseAnnimation.parentView = self.tableView
    pulseAnnimation.setupRefreshControl()
    

Delegate

  • The RefreshDelegate methods can be used to notify start and end refresh.

    extension ViewController: RefreshDelegate {           
      func startRefresh() { }   
      func endRefresh() { }
    }
    

Android Library:

License

  • SSCustomPullToRefresh is available under the MIT license. See the LICENSE file for more info.

Inspired

GitHub

link
Stars: 57
Last commit: 5 weeks ago

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Release Notes

SSCustomPullToRefresh
16 weeks ago

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API