ImpressiveNotifications are custom in-app notifications with 3 types of layouts. The notifications will animate in and out. They will hide when they are clicked on or with an automatic dismissal. It is also available to add custom behavior when notification is tapped.
ImpressiveNotifications is available through Carthage. To install just write into your Cartfile:
github "impresyjna/ImpressiveNotifications"
ImpressiveNotifications is also available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'ImpressiveNotifications'
ImpressiveNotifications is also available through Swift Package Manager. The Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into the swift compiler.
Call INNotifications.show
with a window where it should be shown, type, data structure and customStyle if you want. Only type is necessary.
Built-in notification types are :
.success
.warning
.danger
.custom(UIView)
Example:
INNotifications.show(in: UIApplication.shared.keyWindow, type: .danger, data: INNotificationData(title: "Error", description: "Error notification"))
ImpressiveNotifications gives user possibility to customize view.
INNotificationStyle
is the structure created to customize the appearance of notification.
public struct INNotificationStyle {
let cornerRadius: CGFloat?
let backgroundColor: UIColor?
let titleColor: UIColor?
let descriptionColor: UIColor?
let imageSize: CGSize?
let verticalMargin: CGFloat // Vertical margin for whole notification
let horizontalMargin: CGFloat // Horizontal margin for whole notification (trailing and leading)
}
Example:
INNotifications.show(in: UIApplication.shared.keyWindow, type: .danger, data: INNotificationData(title: "Error", description: "Error notification"), customStyle: INNotificationStyle(cornerRadius: 10.0, backgroundColor: .black, titleColor: .red, descriptionColor: .yellow, imageSize: CGSize(width: 100.0, height: 100.0)))
INNotificationData
is the structure created to customize data on the notification, time and add completionHandler on tap.
From version 0.8.0 is added parent delegate with methods for finish (when notification hides because of delay) and tap on the view. It is alternative to completionHandler on tap.
public struct INNotificationData {
let title: String
let description: String?
let image: UIImage?
let delay: TimeInterval?
let parentDelegate: INNotificationDelegate?
let completionHandler: (() -> Void)?
let hideOnTap: Bool
}
Example:
INNotifications.show(in: UIApplication.shared.keyWindow, type: .danger, data: INNotificationData(title: "Danger", description: "Danger notification", image: UIImage(named: "danger"), delay: 20.0, completionHandler: {
print("Hello")
}
))
If you want to make constant notification(without hiding timer), in INNotificationData delay should be nil. If you want to block hiding on tap just set hideOnTap in this struct as false. To hide the notification is created INNotifications.hide() method.
INNotificationDelegate
is used to notify about finish or tap on notification. It has two functions:
func impressiveNotificationTapped()
func impressiveNotificationFinished()
It is also possible to add custom view created for example in storyboard.
Example:
let storyboard = UIStoryboard(name: "Main", bundle: nil)
let vc = storyboard.instantiateViewController(withIdentifier: "CustomViewController")
INNotifications.show(in: UIApplication.shared.keyWindow, type: .custom(vc.view))
INNotificationPosition
is enum for setup position of notification (top or bottom).
Example:
INNotifications.show(in: UIApplication.shared.keyWindow, type: .danger, data: INNotificationData(title: "Error", description: "Error notification"), position: .bottom)