Close Menu

swiftspinner



Introduction

SwiftSpinner is a lightweight library written in Swift that allows developers to easily incorporate activity spinners into their iOS applications. It provides a customizable and intuitive way to display loading animations and indicate ongoing background processes. Whether you are fetching data from an API, performing lengthy calculations, or waiting for a resource to load, SwiftSpinner can enhance the user experience by providing a visual indicator of progress.



Features

  • Easy integration and customizable API
  • Supports various spinner styles and animations
  • Provides customization options for colors, sizes, and animation durations
  • Offers convenient methods for starting, stopping, and updating spinners
  • Compatible with iOS 9.0 and above



Getting Started

To get started with SwiftSpinner, follow these simple steps:

Step 1: Installation

You can install SwiftSpinner using CocoaPods by adding the following line to your Podfile:

“`ruby
pod ‘SwiftSpinner’, ‘~> 1.2.0’
“`

Then, run `pod install` command in the terminal to install the library.

Step 2: Importing SwiftSpinner

In the class file where you want to use SwiftSpinner, add the following import statement:

“`swift
import SwiftSpinner
“`

Step 3: Using SwiftSpinner

To display a spinner, use the following code snippet:

“`swift
SwiftSpinner.show(“Loading…”)
“`

To hide the spinner, use the following code:

“`swift
SwiftSpinner.hide()
“`

Step 4: Customization

SwiftSpinner provides various options to customize your spinner. Here’s an example of changing the spinner color to blue:

“`swift
SwiftSpinner.show(“Loading…”).addTapHandler({
SwiftSpinner.hide()
}, subtitle: “Tap to hide while connecting!”)

SwiftSpinner.sharedInstance.innerColor = UIColor.blue // Change spinner color
SwiftSpinner.sharedInstance.outerColor = UIColor.blue // Change spinner color
“`



Examples and Use Cases

Here are a few examples showcasing the versatility of SwiftSpinner:

Example 1: Loading Data

In a scenario where you need to load data from a remote server, you can use SwiftSpinner to display a spinner while waiting for the data to be fetched. Here’s how you can achieve this:

“`swift
func fetchData() {
SwiftSpinner.show(“Loading Data…”)

// Fetch data from the server
// Once data is available, update the UI and hide the spinner
YourAPIClient.fetchData { result in
SwiftSpinner.hide()

switch result {
case .success(let data):
// Process and display data on the UI
case .failure(let error):
// Handle the error appropriately
}
}
}
“`

Example 2: Background Process

SwiftSpinner can also be used to indicate the progress of a background process. Let’s say you are performing a lengthy calculation in the background. Use SwiftSpinner to inform the user about the ongoing process. Here’s an example:

“`swift
func performLengthyCalculation() {
SwiftSpinner.show(“Calculating…”)

DispatchQueue.global().async {
// Perform lengthy calculation

DispatchQueue.main.async {
SwiftSpinner.hide()
// Update the UI with the calculated result
}
}
}
“`


Conclusion

SwiftSpinner simplifies the process of integrating activity spinners into your iOS applications. It offers a range of customization options and makes it effortless to indicate ongoing processes. Now you can enhance the user experience by providing clear visual feedback during loading or background tasks. Start incorporating SwiftSpinner into your projects today and delight your users with a better UI experience!

For more details and advanced usage, please refer to the official SwiftSpinner documentation.