Break the silence of your UI, whispering, shouting or whistling at it. Whisper is a component that will make the task of display messages and in-app notifications simple. It has three different views inside.
Display a short message at the bottom of the navigation bar, this can be anything, from a "Great Job!" to an error message. It can have images or even a loader.
Let the users know that something happened inside the app with this beautiful customizable in app notification.
This is the smallest of all, a beautiful discretion in your UI.
All the sounds are fully customizable, from colors to fonts.
Shouts have an optional action that will be called if the user taps on it, and you'll even get a message when the Shout is gone. Finally, if you want to set how long the Shout should be displayed, you have a duration property.
In Whisper, there is no need to think about scroll view insets anymore, this will be handled automatically. As and added bonus, when transitioning from one view controller to another, the next controllers offset will be adjusted like you would expect. It just works!
The usage of the component is so simple, you just create a message in the case of Whisper, an announcement in the case of a Shout or a Murmur in the case of a Whistle, it's done like this:
let message = Message(title: "Enter your message here.", backgroundColor: .red)
// Show and hide a message after delay
show(whisper: message, to: navigationController, action: .show)
// Present a permanent message
show(whisper: message, to: navigationController, action: .present)
// Hide a message
hide(whisperFrom: navigationController)
let announcement = Announcement(title: "Your title", subtitle: "Your subtitle", image: UIImage(named: "avatar"))
show(shout: announcement, to: navigationController, completion: {
print("The shout was silent.")
})
let murmur = Murmur(title: "This is a small whistle...")
// Show and hide a message after delay
show(whistle: murmur, action: .show(0.5))
// Present a permanent status bar message
show(whistle: murmur, action: .present)
// Hide a message
hide(whistleAfter: 3)
If you want to use Whisper with Objective-C, you can find information about it here.
Whisper is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'Whisper'
Whisper is also available through Carthage. To install just write into your Cartfile:
github "hyperoslo/Whisper"
In the future the idea is to keep improving and add some features:
- Improve the offset detection and animation.
- Add more UI related components into Whisper.
- More customization points and more sizes for each whisper.
- Custom actions inside Whispers and Shouts.
- We are open to new and awesome ideas, contribute if you like! :)
Hyper made this with ❤️. If you’re using this library we probably want to hire you! Send us an email at ios@hyper.no.
We would love for you to contribute to Whisper, check the CONTRIBUTING file for more info.
Whisper is available under the MIT license. See the LICENSE file for more info.