SwiftOverlays

SwiftOverlays is a Swift GUI library for displaying various popups and notifications.

Features

Currently SwiftOverlays provides 5 ways to notify user:

• Wait overlay: a simple overlay with activity indicator

• Wait overlay with text

• Overlay with text only
• Overlay with image and text (can be used with PPSwiftGifs to show custom animated GIF instead of UIActivityIndicatorView)
• Notification on top of the status bar, similar to native iOS local/push notifications

Installation

Manual

Just clone and add SwiftOverlays.swift to your project.

Cocoapods

• Make sure that your Cocoapods version is >= 0.36: pod --version
• If not, update it: sudo gem install cocoapods
• pod init in you project root dir
• nano Podfile, add:

pod 'SwiftOverlays', '~> 0.11'
use_frameworks! 

• Save it: ctrl-x, y, enter
• pod update
• Open generated .xcworkspace
• Don't forget to import SwiftOverlays: import SwiftOverlays!

Requirements

• iOS 7.0+ (8.0+ if you use Cocoapods)
• Xcode 6.3
• Swift 1.2 (if you need Swift 1.1, use swift-1.1 branch)

Usage

If you're using CocoaPods, import the library with import SwiftOverlays

You can use UIViewController convenience methods provided by library:

// In your view controller:

// Wait overlay
self.showWaitOverlay()

// Wait overlay with text
let text = "Please wait..."
self.showWaitOverlayWithText(text)

// Overlay with text only
let text = "This is a text-only overlay...\n...spanning several lines"
self.showTextOverlay(text)

// Remove everything
self.removeAllOverlays()

// Notification on top of the status bar
UIViewController.showNotificationOnTopOfStatusBar(annoyingNotificationView!, duration: 5)

Contribution

You are welcome to fork and submit pull requests