besttumi / evwdropdownnotification

EVWDropDownNotification

A simple but yet powerful Swift Dropdown Notification for iOS inspired by AlvaroFranco but rewritten in Swift 2.2 and extended to offer much more customisation

Features

• Written in Swift 2.2
• Customisable Button Alignment (Top, Bottom)
• Customisable Button Parameters (e.g. Corner Radius, Border Color & Width)
• Customisable Button Dipslay (only Top, only Bottom, Both)
• Customisable Icon
• Customisable Independent Text Color & Size for Title and Subtitle
• Customisable Background Color or Blur Effect
• Customisable TapToDismiss Delegate
• Customisable Animation

Example

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

Requirements

Requires iOS SDK version > 8.0

Installation

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

pod "EVWDropDownNotification"

Usage

First import the "EVWDropDownNotification" module:

import EVWDropDownNotification

Then extend your ViewController with the "EVWDropDownNotificationDelegate" and initialise a class variable of type "EVWDropDownNotification":

class ViewController: UIViewController, EVWDropDownNotificationDelegate {

let notification = EVWDropDownNotification()
...

Implement the 3 Delegate Methods:

func dropdownNotificationBottomButtonTapped() {
  //Do something
  ...
  //Dismiss the notification view
  notification.dismissWithGravityAnimation(true)
}
    
func dropdownNotificationTopButtonTapped() {
  //Do something
  ...
  //Dismiss the notification view
  notification.dismissWithGravityAnimation(true)
}
    
func dropdownNotificationDismissedWithTap() {
  //Do something
  ...
  // !!!!! NO NEED TO DISMISS THE NOTIFICATION VIEW !!!!!
}

In your ViewDidLoad set the Properties for the Notification (see below for all available properties):

  notification.delegate = self
  notification.image = UIImage(named: "notification")
  notification.bottomButtonText = "Accept"
  notification.topButtonText = "Cancel"
  notification.dismissOnTap = false
  notification.buttonVerticalAligment = .Bottom
  notification.titleText = "Title Here"
  notification.subtitleText = "Message Here" 

Once all properties set, call the following function to display the Notfication:

 /*
 * NOTE: always provide the ViewController (self.view.Superview) as first parameter
 */
 notification.presentInView(self.view.superview!, withGravityAnimation: true)

Properties

The following public properties are available, please note that some are required and some other are optional because default values have been set:

Required

The only two mandatory properties are the Title and Subtitle of the Notification

  /*
  * Title Attributes
  */
  
  public var titleText:String?
    
  /*
  * Subtitle Attributes
  */
  
  public var subtitleText:String?

Optional

All properties below are optional. !! Note that Buttons will only be displayed if the buttonText is provided !!

  /*
  * Padding between elements
  */
  
  public var paddingBetweenElements:CGFloat = 10
    
  /*
  * Background Color If set, it overwrites the blur effect
  */
  
  public var backgroundColor:UIColor?
    
  /*
  * Title Properties
  */
  
  public var titleLabelFontSize:CGFloat = 19
  public var titleLabelColor:UIColor = UIColor.blackColor()
    
  /*
  * Subtitle Propperties
  */
  
  public var subTitleLabelFontSize:CGFloat = 14
  public var subTitleLabelColor:UIColor = UIColor.blackColor()
    
  /*
  * General Button Properties
  */
  
  public var buttonFontSize:CGFloat = 13
  public var buttonCornerRadius:CGFloat = 10
  public var buttonBorderWidth:CGFloat = 1
  public var buttonBorderColor:UIColor = UIColor.blackColor()
  public var buttonWidth:CGFloat = 75
  public var buttonHeight:CGFloat = 30
  public var buttonVerticalAligment:ButtonPosition = .Bottom
    
  /*
  * Top Button Properties
  */
  
  public var topButtonTextColor:UIColor = UIColor.blackColor()
  public var topButtonBackgroundColor:UIColor = UIColor.clearColor()
    
    
  /*
  * Bottom Button Properties
  */
  
  public var bottomButtonTextColor:UIColor = UIColor.blackColor()
  public var bottomButtonBackgroundColor:UIColor = UIColor.clearColor()
    
  /*
  * Icon Properties -> Size is squared
  */
  
  public var imageSquaredSize:CGFloat = 40
  public var image:UIImage?
    
    
  /*
  * Dismiss On Tap
  */
  
  public var dismissOnTap:Bool = false

Author

CRE8IT GmbH, Switzerland

License

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