esqarrouth/ezloadingactivity

:hatching_chick: Lightweight Swift loading activity for iOS7+

EZLoadingActivity

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

Easy to use:

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

'disableUI' stops user interactions until you hide loadingactivity.

How to dismiss:

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

Failure:

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

Without Animation:

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

Hide Directly:

EZLoadingActivity.hide()

Editing:

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:

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:

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

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

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 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 EZLoadingActivity into your Xcode project using Carthage, specify it in your Cartfile:

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:

import EZLoadingActivity

Install via CocoaPods

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

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:

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.

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

ezloadingactivity's Issues

Multiline text in loader

I want to add a big text in loader

We are downloading your records now. Please wait as this can take some time...

But it appears so small when I use a big text and extra text got truncated.

Is there any way to use multiline text in this library?

Thanks in advance.

Swift 3 issue

I see commits 3 days ago that indicate Swift 3 support. But, I get 40 compiler errors when I include your pod: basic pre-Swift 3 stuff like "NSTimeInterval has been renamed to "TimeInterval". I've cleaned the pod cache, reinstalled. Can you help me?

Swift 4.2 support?

When I install the pod in Swift 4.2, these errors popped up:

My version is 1.01.

LoadingActivity doesn't hide if scrolling started

Lets get to it quickly, lets say we have UITableView and I've showed the LoadingActivity Success and i immediately started scrolling to the bottom, so the LoadingActivity will stay showing until i stop my scroll then it will disappear. why is that ? it should disappear in anyway whenever i scroll or not in a specific time !
Thanks,

EZLoadingActivity: You don't have an activity Instance?

I'm getting an EZLoadingActivity: You don't have an activity Instance problem when trying to call up EZLoadingActivity.hide(success: false, animated: true)

Carthage support?

Are you planning to share this control via Carthage too? I know it's easy to install it direct but still I would like to add it via Carthage. Thanks

Swift Compiler Error, running Xcode 8.1

Below are some of the errors I get in the code. Not sure if it's because of Swift 3.

There's a typo in UIScreen extension

You declared variable CLAOrientation and using Orientation.

Please fix it.

Use multiple instances??

I have a tabbed interface.. and want to show individual loading indicators on each of them..

Update Library for Swift 5

Hi, I'm still using this library on my app, and I was hoping if you have any plans on updating it for Swift 5.

What is the correct way to change the text while the loading activity is presented?

I want to show the user the progress of the time-consuming task that I'm performing. Let's say I want to first show "Performing Task 1 of 10". After the first task is completed, I want to change the text to say "Performing Task 2 of 10" and so on. And after performing all tasks, I want to hide it.

Do I just simply call show with different text multiple times?

Active activity verification

There is a way to verify if already have an active activity?

EZLoadingActivity: You still have an active activity, please stop that before creating a new one

Not work in container view

i have implemented your library, but it just only work on UIViewController, not work in container view.

add completion handler to showWithDelay()

Suggest an additional param for EZLoadingActivity.showWithDelay().

completion callback/handler makes this method far more useful:

@discardableResult
public static func showWithDelay(_ text: String, disableUI: Bool, seconds: Double, completion: (() -> Void)? = nil) -> Bool {
    let showValue = show(text, disableUI: disableUI)
    delay(seconds) { () -> () in
        _ = hide(true, animated: false)
       completion?()
    }
    return showValue
}

Warning: "Result of call to 'hide(_:animated:)' is unused"

Hi,
Your loading indicator works well. However, Xcode alaway gives warnings of "Result of call to hide(_:animated:)' is unused and also in the case of show(). How could I deal with this?

Orientation issue

Thanks for the lovely simple-to-use control.

I noticed however that it doesn't support landscape orientation. It keeps showing the animation based on the initial portrait orientation.

View is pretty large on Ipad

Hey

I love your implementation of this and how simple it is to use!
Tried it for Ipad but it covered almost the entire screen which is a bit brute :D
So I added this setting which let's you manually set the width divider (standard was 1.6)

Probably not the prettiest way to add to it but it works and it's a very fast enhancement :)

In Settings struct
static var CLAWidthDivision = 1.6
In loadingActivity:
let width = sender.view.frame.width / CGFloat(Settings.CLAWidthDivision)
Before calling showMethod:
CozyLoadingActivity.Settings.CLAWidthDivision = 4.6 (about right for Ipad)

Thanks again!

PS don't use github that much so thought I'd add it here and you can mark it as enhancement or something :) Cheers

Hidden in UISplitViewController

The loading indicator is hidden when presented on a UISplitViewController:

Result of call to 'show(_:disableUI:)' is unused

Loading indicator doesnt hide

Hi,
The indicator doesnt hide when i call the hide method. But this hide after a few second after i passed on the hide method ( +/-10 seconds)

After this, when i continue to press my button for show the indicator, this doesnt show.

The view isn't in the centre when in a VC that is presented modally or is the master/detail

I tried to present an EZLoadingActivity in a Form Sheet view controller and it is off centred. It appears at about the bottom left corner of the form sheet. It isn't centred either when it is in a master-detail view controller.

To reproduce, create a view controller A in the storyboard. Add a button that triggers a segue like this:

Connect the segue to view controller B.

In view controller B viewDidLoad, show the EZLoadingActivity.

I think this is due to showing the view in the window. Can you do something about it so that it always appears centered in the current view controller?

Swift 3

The framework should be converted to swift 3 syntax.

Is there any easy way to present without text?

Is there any easy way to present without text?

EZLoadingActivity: You don't have an activity instance

i shoud call the show function in viewdidappear but that's not what i want . it's a bug for ios10. How to slove it?

[WIP] travis-ci integration

what all you think about integrating travis-ci in this project ?

i could able to do it , let me tell your thoughts

Text is not visible with indicator

EZLoadingActivity.show("Updating Expense", disableUI: true)

i am using EZLoadingActivity to show indicator with text. But on some screen text is not visible with indicator. How can i resolve this issue ?

there are an android version??

Feature Request: Optionally show the loading activity as a subview of the window?

Currently, the LoadingActivity view seems to be added as a subview of the topViewController. This means that I cannot show the loading activity, and keep it showing while I perform a segue that goes to another VC.

I think adding the loading activity as a subview of the window should fix this, but this would not work if the view controller is not full screen (see #23). Therefore, I think it would be best to provide an option to add the loading activity to the window.

Either:

• Accept a UIViewController? parameter in show. When this is nil, show the loading activity in the window, otherwise show it as a subview of the view of the VC, or
• Accept a Bool parameter called showAsSubviewOfWindow. This won't break existing code.

Do you think this is a good idea?