Skip to content

A framework for displaying notifications similar to Apple's iOS 7 and iOS 8 notifications.

Notifications You must be signed in to change notification settings

WilliamRen/LNNotificationsUI

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LNNotificationsUI

LNNotificationsUI is a framework for displaying notifications similar to Apple's iOS 7 and iOS 8 notifications. It is meant to complement the native look and feel, by providing a pixel-accurate (as much as possible) recreation of the notifications.

See a video here.

Features

  • Native look & feel
  • Support for notifications of multiple "applications"
  • Customizeable notifications
  • Different banner styles:

 

  • Settings for registered apps:

 

  • Sounds support
  • Xcode 6 framework

Adding to Your Project

Drag the LNNotificationsUI project to your project, and add LNNotificationsUI.framework under Link Binary With Libraries in your project target. Make sure to add LNNotificationsUIAssets.xcassets to your target's Copy Bundle Resources.

Using the Framework

First import the umbrella header file:

#import <LNNotificationsUI/LNNotificationsUI.h>

Before being able to post notifications, you need to register at least one "application" with the system. "Applications" are logical differenciators, each with its own identifier, name and icon. For example, a productivity app with an e-mail client and a calendar may register two applications, "Mail" and "Calendar" with different icons and default titles.

[[LNNotificationCenter defaultCenter] registerApplicationWithIdentifier:@"mail_app_identifier" name:@"Mail" icon:[UIImage imageNamed:@"MailApp"] defaultSettings:LNNotificationDefaultAppSettings];
[[LNNotificationCenter defaultCenter] registerApplicationWithIdentifier:@"cal_app_identifier" name:@"Calendar" icon:[UIImage imageNamed:@"CalApp"]  defaultSettings:LNNotificationDefaultAppSettings];

Note: For all available options for the default settings, take a look at the LNNotificationAppSettings class definition. LNNotificationDefaultAppSettings is provided as a convenience for default settings.

Now the system is ready to post notifications. Create a notificaiton object, set the desired parameters and post it.

LNNotification* notification = [LNNotification notificationWithMessage:@"You've Got Mail!"];
	
[[LNNotificationCenter defaultCenter] presentNotification:notification forApplicationIdentifier:@"mail_app_identifier"];

Note: For all available notification properties, take a look at the LNNotification class definition.

To listen to taps on notifications by the user, register to the LNNotificationWasTappedNotification notification. You can register for specific notification objects or for all, by passing nil as the object.

[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(notificationWasTapped:) name:LNNotificationWasTappedNotification object:nil];

Use the notification.object to get the tapped LNNotification object.

- (void)notificationWasTapped:(NSNotification*)notification
{
	LNNotification* tappedNotification = notification.object;
	
	// Handle tap here.
}

To display the notification settings view controller, create an instance of LNNotificationSettingsController, either in code or storyboard and display it. This view controller will display all registered apps, and will allow the user to select how notifications are presented to him. If only one app is registered, its settings will appear in this view controller. If there two or more apps registered, a list of apps will appear and selecting an app will show its settings.

About

A framework for displaying notifications similar to Apple's iOS 7 and iOS 8 notifications.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published