/Elissa

Elissa displays a notification on top of a UITabBarItem to reveal additional information.

Primary LanguageShellMIT LicenseMIT

Elissa

CI Status Version License Platform

Display a notification on top of a UITabBarItem to reveal additional user guidance.

Usage

You can display Elissa according to your app’s theming by creating and passing a fully customisable configuration.

var elissaConfig = ElissaConfiguration()
elissaConfig.message = "Find your favorites here"
elissaConfig.image = UIImage(named: "heartIcon") ?? UIImage()
elissaConfig.font = UIFont.systemFontOfSize(17)
elissaConfig.textColor = UIColor(red: 91/255, green: 91/255, blue: 91/255, alpha: 1.0)
elissaConfig.backgroundColor = UIColor(red: 241/255, green: 215/255, blue: 85/255, alpha: 1.0)

Presenting Elissa is as simple as that:

showElissaFromTabbar(itemIndex: 4, configuration: elissaConfig) { 
	Elissa.dismiss()
}

Additionally (and optionally) you can pass a closure that is executed once the user taps the notification.

Example

Per default, Elissa will try to align to the center of the UITabBarItem. However she will never move out of sight to her parent’s view screen bounds. Therefor she applies an offset calculation that will also move the little arrow pointer accordingly.

To run the example project, clone the repo, and run pod install from the Example directory first.

Installation

Elissa is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "Elissa"

Author

Kersten Broich, kersten.broich@kitchenstories.de

License

Elissa is available under the MIT license. See the LICENSE file for more info.