apegroup / apesuperhud Goto Github PK

View Code? Open in Web Editor NEW

155.0 25.0 26.0 227 KB

A simple way to display a HUD with a message or progress information in your application.

Home Page: http://apegroup.com/

License: MIT License

Ruby 3.03% Swift 90.26% Objective-C 6.71%

hud spinner swift cocoapods carthage progress

apesuperhud's Introduction

APESuperHUD

A simple way to display a HUD with a message or progress information in your application.

Features

Simplicity.
Customizable. See Change appearance.
Fully written in Swift.
Unit tests.

Requirements

iOS 9 or later.
Xcode 9 (Swift 4.1) or later.
- For Swift 3.0 use version 1.1.3
- For Swift 2.2 use version 0.6

Installation

CocoaPods

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

platform :ios, '9.0'
use_frameworks!

target 'MyApp' do
    pod 'APESuperHUD', :git => 'https://github.com/apegroup/APESuperHUD.git'
end

Note that this requires CocoaPods version 36, and your iOS deployment target to be at least 9.0:

Carthage

You can use Carthage to install APESuperHUD by adding it to your Cartfile:

github "apegroup/APESuperHUD"

Usage

Don't forget to import.

import APESuperHUD

Show hud with icon

let image = UIImage(named: "apegroup")!
APESuperHUD.show(style: .icon(image: image, duration: 3.0), title: "Hello", message: "world")

// Or create a instance of APESuperHud

/*
let hudViewController = APESuperHUD(style: .icon(image: image, duration: 3), title: "Hello", message: "world")
present(hudViewController, animated: true)
*/

Show hud with loading indicator

APESuperHUD.show(style: .loadingIndicator(type: .standard), title: nil, message: "Loading...")

DispatchQueue.main.asyncAfter(deadline: .now() + 3.0, execute: {
    APESuperHUD.dismissAll(animated: true)
})

// Or create a instance of APESuperHud

/*
let hudViewController = APESuperHUD(style: .loadingIndicator(type: .standard), title: nil, message: "Loading...")
present(hudViewController, animated: true)

DispatchQueue.main.asyncAfter(deadline: .now() + 3.0, execute: {
    hudViewController.dismiss(animated: true)
})
*/

Show hud with title and message

APESuperHUD.show(style: .textOnly, title: "Hello", message: "world")

DispatchQueue.main.asyncAfter(deadline: .now() + 3.0, execute: {
    APESuperHUD.dismissAll(animated: true)
})

// Or create a instance of APESuperHud

/*
let hudViewController = APESuperHUD(style: .textOnly, title: "Hello", message: "world")
present(hudViewController, animated: true)

DispatchQueue.main.asyncAfter(deadline: .now() + 3.0, execute: {
    hudViewController.dismiss(animated: true)
})
*/

Show hud with updates

APESuperHUD.show(style: .loadingIndicator(type: .standard), title: nil, message: "Loading...")

DispatchQueue.main.asyncAfter(deadline: .now() + 3.0, execute: {
    APESuperHUD.show(style: .textOnly, title: "Done loading", message: nil)

    DispatchQueue.main.asyncAfter(deadline: .now() + 3.0, execute: {
        let image = UIImage(named: "apegroup")!
        APESuperHUD.show(style: .icon(image: image, duration: 3.0), title: nil, message: nil)
    })
})

Change appearance

/// Text color of the title text inside the HUD
HUDAppearance.titleTextColor = UIColor.black

/// Text color of the message text inside the HUD
HUDAppearance.messageTextColor = UIColor.black

/// The color of the icon in the HUD
HUDAppearance.iconColor = UIColor.black

/// The background color of the view where the HUD is presented
HUDAppearance.backgroundColor = UIColor.black.withAlphaComponent(0.5)

/// The background color of the HUD view
HUDAppearance.foregroundColor = UIColor.white

/// The color of the loading indicator
HUDAppearance.loadingActivityIndicatorColor = UIColor.gray

/// The corner radius of the HUD
HUDAppearance.cornerRadius = 10.0

/// Enables/disables shadow effect around the HUD
HUDAppearance.shadow = true

/// The shadow color around the HUD
HUDAppearance.shadowColor = UIColor.black

/// The shadow offset around the HUD
HUDAppearance.shadowOffset = CGSize(width: 0, height: 0)

/// The shadow radius around the HUD
HUDAppearance.shadowRadius = 6.0

/// The shadow opacity around the HUD
HUDAppearance.shadowOpacity = 0.15

/// Enables/disables removal of the HUD if the user taps on the screen
HUDAppearance.cancelableOnTouch = true

/// The info message font in the HUD
HUDAppearance.messageFont = UIFont.systemFont(ofSize: 13, weight: .regular)

/// The title font in the HUD
HUDAppearance.titleFont = UIFont.systemFont(ofSize: 20, weight: .bold)

/// The size of the icon inside the HUD
HUDAppearance.iconSize = CGSize(width: 48, height: 48)

/// The HUD size
HUDAppearance.hudSize = CGSize(width: 144, height: 144)

/// The HUD fade in duration
HUDAppearance.animateInTime = 0.7

/// The HUD fade out duration
HUDAppearance.animateOutTime = 0.7

Contributing

All people are welcome to contribute. See CONTRIBUTING for details.

License

APESuperHUD is released under the MIT license. See LICENSE for details.

apesuperhud's People

Contributors

Stargazers

Watchers

apesuperhud's Issues

I can not use on Swift 4.2

I discovered the problem in the show function and dismissAll. compactMap is no longer supported.

Thanks!!

Screen autorotate is disable when call `endGeneratingDeviceOrientationNotifications` in `removeHud` method

Hey,guy.I use your great third-part code in my project, but i find you call call endGeneratingDeviceOrientationNotifications in removeHud method, that make my device autoroate disable.I want to know if i remove this endGeneratingDeviceOrientationNotifications, is there any negative impact ?

Addition

Hello. Thank you for the framework. It works good.
Please, can you add a functions which shows weather the HudView is visible on the given view or not.
Like this:

public static func isVisible(in view: UIView) -> Bool {
        
        var status = false
        if getHudView(presentingView: view) != nil {
            
            status = true
        }
        
        return status
}

Thanks!

Documentation is not up to date with code

For example, IconType.Standard does not exists in code

Try out the usage examples in the Readme file and you'll see what is not consistent with the code base.

How can I user APESuperHUD in Xcode 7.3?

I got some errors while compiling my project, such as:
Type 'UIColor' has no member 'black'.

Should I install a old version with Pods?

Ability to change the loadingActivityIndicator size

Hi there,

Thanks for this great and flexible HUD. One thing I'd love to adjust though is the size of the loadingActivityIndicator. I'm not using the title or message so the loadingActivityIndicator looks a little small on its own.
I've noticed you are using the default loadingActivityIndicator and I know it's not very customizable but there are some SO posts that show how to adjust the size of the native loadingActivityIndicator:

activityIndicator.transform = CGAffineTransform(scaleX: 2, y: 2)
https://stackoverflow.com/questions/2638120/can-i-change-the-size-of-uiactivityindicator

It's an easy way of making the loadingActivityIndicator bigger even though the loadingActivityIndicator appears a little blurry.

Eventually that'd be better I guess to have this loadingActivityIndicator a custom animation like they do in https://github.com/SVProgressHUD/SVProgressHUD for example.

Cheers and have a great weekend!

Update README with new gif animations

Blur effect not working well in static table section

Table section name do not blur

Update README images

progress display?

Perhaps i am just missing it, but there seems to be no built-in ability to show a progress of (for example), a web view loading.

Hopefully i am wrong?

Can build app anymore

Keep getting these errors:
APESuperHUD/Source/HudView.swift:403:71: Type 'UILayoutPriority' (aka 'Float') has no member 'RawValue'

APESuperHUD/Source/HudView.swift:468:66: Type 'UILayoutPriority' (aka 'Float') has no member 'required'

APESuperHUD/Source/HudView.swift:402:63: Type 'UILayoutPriority' (aka 'Float') has no member 'RawValue'

APESuperHUD/Source/HudView.swift:453:60: Type 'UILayoutPriority' (aka 'Float') has no member 'required'

Swift 4 Compile Error

Please solve this problem , I can't open this one

Custom Loading Rotary Pictures?

Custom Loading Rotary Pictures？

AppStore Submit Issue

When I try to upload App Store, I get to following error.
PS I use carthage.

Thanks for your support.

2016-08-25 13:27:26 +0000 [MT] Presenting: Error Domain=DVTFoundationNSBundleAdditionsErrorDomain Code=1 "Couldn't find platform family in Info.plist CFBundleSupportedPlatforms or Mach-O LC_VERSION_MIN for APESuperHUD" UserInfo={NSLocalizedDescription=Couldn't find platform family in Info.plist CFBundleSupportedPlatforms or Mach-O LC_VERSION_MIN for APESuperHUD}

Crash occurred

I'm getting some (seems random) crashes due to https://github.com/apegroup/APESuperHUD/blob/master/Source/HudView.swift#L196 and reading it that forced unwrap doesn't seem very safe, doesn't it? Maybe optionalize or guard against nils?

This is happening using latest Cocoapods available version of the library on Xcode 7 (latest update) on iOS 9 compile target.

Ambigous reference

Hi,

When I'm trying to display message, I got this :

With 0.6 version and cocoapod. Have you any solution ?

Thank you !

iOS 10 backgroundBlurEffect issue

Hello,

Since iOS 10 update, I found issue with backgroundBlurEffect property. The background seem to appear blurred / un blurred / blurred when the loader appear.

To reproduce this issue, just replace in the demo project
APESuperHUD.appearance.backgroundBlurEffect = .none
by :
APESuperHUD.appearance.backgroundBlurEffect = .dark

Have you any solution for this issue ? :)

Thank you