/ISMessages

This is simple extension for presenting system-wide notifications from top/bottom of device screen.

Primary LanguageObjective-CMIT LicenseMIT

ISMessages

Version CocoaPods GitHub license

This is simple extension for presenting system-wide notifications from top/bottom of device screen.

Requirements

  • Requires iOS 8.2 or later
  • Requires Automatic Reference Counting (ARC)

Features

  • Simple use actions
  • Call from anywhere in app

Installation

CocoaPods

To install ISMessages using CocoaPods, please integrate it in your existing Podfile, or create a new Podfile:

target 'MyApp' do
  pod 'ISMessages'
end

Then run pod install.

Manual

Add ISMessages folder to your project

Usage

#import <ISMessages/ISMessages.h>

Presenting notification

All messages can simply presented without customization and callback action via static method call:

[ISMessages showCardAlertWithTitle:@"This is your title!" 
            message:@"This is your message!"  
            duration:3.f 
            hideOnSwipe:YES 
            hideOnTap:YES 
            alertType:ISAlertTypeSuccess 
            alertPosition:ISAlertPositionTop 
	    	didHide:^(BOOL finished) {
               NSLog(@"Alert did hide.");
            }];

Message with customization and callback action:

ISMessages* alert = [ISMessages cardAlertWithTitle:@"This is custom alert with callback"
                                message:@"This is your message!!"
                                iconImage:[UIImage imageNamed:@"Icon-40"]
                                duration:3.f
                                hideOnSwipe:YES
                                hideOnTap:YES
                                alertType:ISAlertTypeCustom
                                alertPosition:ISAlertPositionTop];
				
alert.titleLabelFont = [UIFont boldSystemFontOfSize:15.f];
alert.titleLabelTextColor = [UIColor blackColor];

alert.messageLabelFont = [UIFont italicSystemFontOfSize:13.f];
alert.messageLabelTextColor = [UIColor whiteColor];

alert.alertViewBackgroundColor = [UIColor colorWithRed:96.f/255.f 
					  green:184.f/255.f 
					  blue:237.f/255.f 
					  alpha:1.f];

[alert show:^{
     NSLog(@"Callback is working!");
} didHide:^(BOOL finished) {
     NSLog(@"Custom alert without image did hide.");
}];				

Messages can be displayed from any location in app, even not associated with UI.

Hiding Messages

Notifications will hidden automatically after your duration or using static method

[ISMessages hideAlertAnimated:YES];

Also you can just tap/swipe {on} message to hide it.

Author

Ilia

License

Usage is provided under the MIT License. See LICENSE for full details.