Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Esqarrouth/EZLoadingActivity

:hatching_chick: Lightweight Swift loading activity for iOS7+
https://github.com/Esqarrouth/EZLoadingActivity

Last synced: 12 days ago
JSON representation

:hatching_chick: Lightweight Swift loading activity for iOS7+

Host: GitHub
URL: https://github.com/Esqarrouth/EZLoadingActivity
Owner: Esqarrouth
License: mit
Created: 2015-06-04T11:25:59.000Z (over 9 years ago)
Default Branch: master
Last Pushed: 2022-03-18T23:58:59.000Z (almost 3 years ago)
Last Synced: 2024-08-10T02:01:53.155Z (4 months ago)
Language: Swift
Homepage:
Size: 85.9 KB
Stars: 608
Watchers: 20
Forks: 82
Open Issues: 10
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-ios - EZLoadingActivity - Lightweight loading activity HUD. (UI / Activity Indicator)
awesome-swift - EZLoadingActivity - Lightweight loading activity HUD. (Libs / UI)
fucking-awesome-swift - EZLoadingActivity - Lightweight loading activity HUD. (Libs / UI)

README

        EZLoadingActivity

==========

[![CocoaPods Compatible](https://img.shields.io/cocoapods/v/EZLoadingActivity.svg)](https://img.shields.io/cocoapods/v/EZLoadingActivity.svg)

[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)











Lightweight Swift loading activity for iOS7+. Really simple to use, just add the class and write 1 line of code. 

![demo](http://i.imgur.com/xLHKvSB.gif)

## Easy to use:

```swift

EZLoadingActivity.show("Loading...", disableUI: true)

```

'disableUI' stops user interactions until you hide loadingactivity.  

## How to dismiss:

```swift

EZLoadingActivity.hide(success: true, animated: true)

```

## Failure:

```swift

EZLoadingActivity.hide(success: false, animated: true)

```

![demo](http://i.imgur.com/x2BAEmG.gif)

## Without Animation:

```swifts

EZLoadingActivity.hide(success: true, animated: false)

```

![demo](http://i.imgur.com/fXvCbIy.gif)

## Hide Directly:

```swift

EZLoadingActivity.hide()

```

![demo](http://i.imgur.com/2cySGp6.gif)

## Editing:

```swift

EZLoadingActivity.Settings.SuccessColor = UIColor.blueColor()

EZLoadingActivity.show("Loading...", disableUI: false)

```

|Settings Options|

| -------------|

|BackgroundColor|

|ActivityColor|

|TextColor|

|FontName|

|SuccessIcon|

|FailIcon|

|SuccessText|

|FailText|

|SuccessColor|

|FailColor|

|ActivityWidth|

|ActivityHeight|

## Example Use Case:

```swift

EZLoadingActivity.show("Uploading...", disableUI: false)

var postObject = PFObject(className: "className")

postObject.saveInBackgroundWithBlock { (succeeded: Bool, error: NSError!) -> Void in

    if error == nil {

       if succeeded == true {

          EZLoadingActivity.hide(success: true, animated: false)

          print("Upload Complete")

        } else {

          EZLoadingActivity.hide(success: false, animated: true)

          print("Upload Failed")

       }

    } else {

        EZLoadingActivity.hide(success: false, animated: true)

        print("Error")

    }

}

```

######Showing EZLoadingActivity for a certain time:

```swift

EZLoadingActivity.showWithDelay("Waiting...", disableUI: false, seconds: 2)

```

######Showing EZLoadingActivity from App Window(For example: for Split view controller):

```swift

EZLoadingActivity.Settings.LoadOverApplicationWindow = true

```

## No object tracking:

EZLoadingActivity is a singleton object so you don't need to keep track of its instance.  

##Installation (~10 seconds)

1. Download and drop 'EZLoadingActivity.swift' in your project.  

2. Congratulations!  

## Install via Carthage

[Carthage](https://github.com/Carthage/Carthage) is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage with [Homebrew](http://brew.sh/) using the following command:

```bash

$ brew update

$ brew install carthage

```

To integrate EZLoadingActivity into your Xcode project using Carthage, specify it in your `Cartfile`:

```ogdl

github "goktugyil/EZLoadingActivity"

```

Run `carthage update` to build the framework and drag the built `EZLoadingActivity.framework` into your Xcode project.

Then on the top of files where you are going to use this:

```swift

import EZLoadingActivity

```

## Install via CocoaPods

You can use [CocoaPods](http://cocoapods.org/) to install `EZLoadingActivity` by adding it to your `Podfile`:

```ruby

platform :ios, '8.0'

use_frameworks!

pod 'EZLoadingActivity' #Stable release for Swift 3.0

pod 'EZLoadingActivity', :git => 'https://github.com/goktugyil/EZLoadingActivity.git' #Latest release for Swift 3.0

pod 'EZLoadingActivity', '~> 0.8' #For Swift 2.2

```

Then on the top of files where you are going to use this:

```swift

import EZLoadingActivity

```

##Requirements

- Xcode 6 or later (Tested on 7)

- iOS 7 or later (Tested on 9)

##Possible features

- More customization

- Pod support 

- OSX compatibility and add here https://github.com/AndrewSB/awesome-osx

##License

EZLoadingActivity is available under the MIT license. See the [LICENSE file](https://github.com/goktugyil/EZLoadingActivity/blob/master/LICENSE).

##Keywords

swift, hud, loading, activity, progresshud, progress, track, spinner,