🍞 Toast for Swift
Swift Objective-C Ruby
Latest commit d16e35c Oct 10, 2016 @devxoul committed on GitHub Merge pull request #93 from hypery2k/travisci
Travis CI support

README.md

Toaster

Build Status Swift CocoaPods Carthage compatible

Android-like toast with very simple interface. (formerly JLToast)

Toaster is written in Swift 3.0. If you're looking for Swift 2 compatible version, see the JLToast 1.4.2.

Features

  • Queueing: Centralized toast center manages the toast queue.
  • Customizable: See the Appearance section.

At a Glance

import Toaster

Toast(text: "Hello, world!").show()

Installation

  • For iOS 8+ projects with CocoaPods:

    pod 'Toaster', '~> 2.0'
  • For iOS 8+ projects with Carthage:

    github "devxoul/Toaster" ~> 2.0
    
  • For iOS 7 projects: I recommend you to try CocoaSeeds, which uses source code instead of dynamic frameworks. Sample Seedfile:

    github 'devxoul/Toaster', '2.0.1', :files => 'Sources/*.{swift,h}'

Getting Started

Setting Duration and Delay

Toast(text: "Hello, world!", duration: Delay.long)
Toast(text: "Hello, world!", delay: Delay.short, duration: Delay.long)

Removing Toasts

  • Removing toast with reference:

    let toast = Toast(text: "Hello")
    toast.show()
    toast.cancel() // remove toast immediately
  • Removing current toast:

    if let currentToast = ToastCenter.default.currentToast {
        currentToast.cancel()
    }
  • Removing all toasts:

    ToastCenter.default.cancelAll()

Appearance

Since Toaster 2.0.0, you can use UIAppearance to set default appearance. This is an short example to set default background color to red.

ToastView.appearance().backgroundColor = .red

Supported appearance properties are:

Property Type Description
backgroundColor UIColor Background color
cornerRadius CGFloat Corner radius
textInsets UIEdgeInsets Text inset
textColor UIColor Text color
font UIFont Font
bottomOffsetPortrait CGFloat Vertical offfset from bottom in portrait mode
bottomOffsetLandscape CGFloat Vertical offfset from bottom in landscape mode

Screenshots

Toaster Screenshot

License

Toaster is under WTFPL. You can do what the fuck you want with Toast. See LICENSE file for more info.