Home

Awesome

Toaster

Build Status Swift CocoaPods Carthage compatible

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

Screenshots

Toaster Screenshot

Features

At a Glance

import Toaster

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

Compatibility

Toaster supports the same minimum Xcode version as App Store submission (https://developer.apple.com/ios/submit/):

Toaster supports the same Swift versions as Xcode (https://developer.apple.com/support/xcode/):

Toaster supports all Apple platforms.

Installation

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

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:

PropertyTypeDescription
backgroundColorUIColorBackground color
cornerRadiusCGFloatCorner radius
textInsetsUIEdgeInsetsText inset
textColorUIColorText color
fontUIFontFont
bottomOffsetPortraitCGFloatVertical offfset from bottom in portrait mode
bottomOffsetLandscapeCGFloatVertical offfset from bottom in landscape mode
shadowPathCGPathThe shape of the layer’s shadow
shadowColorUIColorThe color of the layer’s shadow
shadowOpacityFloatThe opacity of the layer’s shadow
shadowOffsetCGSizeThe offset (in points) of the layer’s shadow
shadowRadiusCGFloatThe blur radius (in points) used to render the layer’s shadow
maxWidthRatioCGFloatThe width ratio of toast view in window
useSafeAreaForBottomOffsetBoolA Boolean value that determines safeAreaInsets.bottom is added to bottomOffset

Attributed string

Since Toaster 2.3.0, you can also set an attributed string:

Toast(attributedText: NSAttributedString(string: "AttributedString Toast", attributes: [NSAttributedString.Key.backgroundColor: UIColor.yellow]))

Accessibility

By default, VoiceOver with UIAccessibility is enabled since Toaster 2.3.0. To disable it:

ToastCenter.default.isSupportAccessibility = false

License

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