Simple and intuitive alert view. Similar to push notification effect. This class uses UIAlertView default methods and protocols.
[![Build Status](https://travis-ci.org/NZN/NZAlertView.svg?branch=master)](https://travis-ci.org/NZN/NZAlertView) [![Cocoapods](https://cocoapod-badges.herokuapp.com/v/NZAlertView/badge.png)](http://beta.cocoapods.org/?q=NZAlertView) [![Cocoapods](https://cocoapod-badges.herokuapp.com/p/NZAlertView/badge.png)](http://beta.cocoapods.org/?q=NZAlertView) [![Analytics](https://ga-beacon.appspot.com/UA-48753665-1/NZN/NZAlertView/README.md)](https://github.com/igrigorik/ga-beacon)
NZAlertView works on iOS 6.0+ version and is compatible with ARC projects. It depends on the following Apple frameworks, which should already be included with most Xcode templates:
- Foundation.framework
You will need LLVM 3.0 or later in order to build NZAlertView.
NZAlertView use UIImage-Helpers project for manipulating images.
CocoaPods is the recommended way to add NZAlertView to your project.
- Add a pod entry for NZAlertView to your Podfile:
pod 'NZAlertView'
- Install the pod(s) by running:
pod install
Alternatively you can directly add source files to your project.
- Download the latest code version or add the repository as a git submodule to your git-tracked project.
- Open your project in Xcode, then drag and drop all files at
NZAlertView
folder onto your project (use the "Product Navigator view"). Make sure to select Copy items when asked if you extracted the code archive outside of your project.
###Info
- Works at iPad and iPhone
- Works with or without status bar
- Only works at portrait mode
- The alert duration time can be modified (default: 5 seconds)
- The animation duration time can be modified (default: 0.6 seconds)
- The text alignment can be changed (default: left alignment)
- Only 1 alert is displayed at a time
- Delegates are similar to
UIAlertView
###Styles
- NZAlertStyleError
- NZAlertStyleSuccess
- NZAlertStyleInfo
###Show
#import "NZAlertView.h"
...
{
// There are several ways to init, just look at the class header
NZAlertView *alert = [[NZAlertView alloc] initWithStyle:NZAlertStyleSuccess
title:@"Alert View"
message:@"This is an alert example."
delegate:nil];
[alert setTextAlignment:NSTextAlignmentCenter];
[alert show];
// or
[alert showWithCompletion:^{
NSLog(@"Alert with completion handler");
}];
}
###Delegate
- All delegates are optional
#import "NZAlertViewDelegate.h"
...
- (void)willPresentNZAlertView:(NZAlertView *)alertView;
- (void)didPresentNZAlertView:(NZAlertView *)alertView;
- (void)NZAlertViewWillDismiss:(NZAlertView *)alertView;
- (void)NZAlertViewDidDismiss:(NZAlertView *)alertView;
###Setters and getters
@property (nonatomic, assign) id delegate;
@property (nonatomic, assign) NZAlertStyle alertViewStyle;
@property (nonatomic, copy) NSString *title;
@property (nonatomic, copy) NSString *message;
@property (nonatomic, readonly, getter = isVisible) BOOL visible;
@property (nonatomic, assign) NSString *fontName;
@property (nonatomic) NSTextAlignment textAlignment;
@property (nonatomic, assign) CGFloat alertDuration;
@property (nonatomic, assign) CGFloat animationDuration;
@property (nonatomic, assign) CGFloat screenBlurLevel;
###Images and colors
- If you want to change, the images are in the bundle:
NZAlertView-Icons.budle
- To customize the colors, extend the
NZAlertViewColor
class and override the methods:errorColor
,infoColor
andsuccessColor
.
This code is distributed under the terms and conditions of the MIT license.
A brief summary of each NZAlertView release can be found on the wiki.
##To-do Items
###Orientation
- Support for landscape mode
- iPhone 6 and iPhone 6 Plus support
###Design
- Add style with buttons
- Create a
NZAlertStyleCustom
style