https://github.com/xxxAIRINxxx/VHUD

Simple HUD.
https://github.com/xxxAIRINxxx/VHUD

Last synced: 3 months ago
JSON representation

Simple HUD.

• Host: GitHub
• URL: https://github.com/xxxAIRINxxx/VHUD
• Owner: xxxAIRINxxx
• License: mit
• Created: 2016-08-18T15:14:51.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2019-03-26T08:52:12.000Z (almost 6 years ago)
• Last Synced: 2024-04-29T20:21:00.000Z (10 months ago)
• Language: Swift
• Size: 495 KB
• Stars: 138
• Watchers: 6
• Forks: 17
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-ios - VHUD
• awesome-ios-star - VHUD

README

        
# VHUD

[![Version](https://img.shields.io/cocoapods/v/VHUD.svg?style=flat)](http://cocoadocs.org/docsets/VHUD)

[![Swift 5.0](https://img.shields.io/badge/Swift-5.0-orange.svg?style=flat)](https://developer.apple.com/swift/)

[![Platforms iOS](https://img.shields.io/badge/Platforms-iOS-lightgray.svg?style=flat)](https://developer.apple.com/swift/)

[![Xcode 10.2](https://img.shields.io/badge/Xcode-10.2-blue.svg?style=flat)](https://developer.apple.com/swift/)

Simple HUD.

![Capture](Images/capture.jpg)

VHUD is inspired by [PKHUD](https://github.com/pkluz/PKHUD).

## Example

### Show

```swift

import VHUD

func example() {

  var content = VHUDContent(.loop(3.0))

  content.loadingText = "Loading.."

  content.completionText = "Finish!"

  VHUD.show(content)

}

```

### Dismiss

```swift

// duration, deley(Option), text(Option), completion(Option)

VHUD.dismiss(1.0, 1.0)

```

## Mode

- Loop

- Duration

- PercentComplete

## Customization

### Shape

- circle

```swift

var content = VHUDContent(.loop(3.0))

content.shape = .circle

VHUD.show(content)

```

![Capture](Images/circle.jpg)

- round

```swift

var content = VHUDContent(.loop(3.0))

content.shape = .round

VHUD.show(content)

```

![Capture](Images/round.jpg)

And Custom (using closure)

### Style

- light

```swift

var content = VHUDContent(.loop(3.0))

content.shape = .circle

content.style = .light

VHUD.show(content)

```

![Capture](Images/light.jpg)

- dark

```swift

var content = VHUDContent(.loop(3.0))

content.shape = .circle

content.style = .dark

VHUD.show(content)

```

![Capture](Images/dark.jpg)

- blur

```swift

var content = VHUDContent(.loop(3.0))

content.shape = .circle

content.style = .blur(.light)

VHUD.show(content)

```

![Capture](Images/blur.jpg)

### Background

- none

```swift

var content = VHUDContent(.loop(3.0))

content.shape = .circle

content.style = .blur(.light)

content.background = .none

VHUD.show(content)

```

![Capture](Images/bg_none.jpg)

- color

```swift

var content = VHUDContent(.loop(3.0))

content.shape = .circle

content.style = .dark

content.background = .color(#colorLiteral(red: 0.937254902, green: 0.937254902, blue: 0.9568627451, alpha: 0.7))

VHUD.show(content)

```

![Capture](Images/bg_color.jpg)

- blur

```swift

var content = VHUDContent(.loop(3.0))

content.shape = .circle

content.style = .light

content.background = .blur(.dark)

VHUD.show(content)

```

![Capture](Images/bg_blur.jpg)

## Requirements

* Xcode 10+

|            | OS                         | Swift         |

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

| **v1.1.x** | iOS 8+ | 3.0      |

| **v1.2.x** | iOS 8+ | 3.2      |

| **v1.3.x** | iOS 9+ | 4.1      |

| **v1.4.x** | iOS 9+ | 4.2      |

| **v1.5.x** | iOS 10+ | 5.0      |

## Installation

#### CocoaPods

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

```ruby

use_frameworks!

pod 'VHUD'

```

To get the full benefits import `VHUD` wherever you import UIKit

``` swift

import UIKit

import VHUD

```

#### Carthage

You can use [Carthage](https://github.com/Carthage/Carthage) to install `VHUD` by adding it to your `Cartfile`:

```

github "xxxAIRINxxx/VHUD"

```

To get the full benefits import `VHUD` wherever you import UIKit

``` swift

import UIKit

import VHUD

```

#### Manually

1. Download and drop ```/Sources``` folder in your project.  

2. Congratulations!  

## License

MIT license. See the LICENSE file for more info.