/OLGhostAlertView

Temporary and unobtrusive translucent alert view for iPhone and iPad.

Primary LanguageObjective-COtherNOASSERTION

OLGhostAlertView

Temporary and unobtrusive translucent alert view for iPhone and iPad. Here's what it looks like: iPad / iPhone

Details

OLGhostAlertView allows you to present a translucent view with a title and an optional message on the bottom of the screen. Use it to inform your user about temporary issues that do not require any immediate action and are not blocking the flow of your app.

OLGhostAlertView can have a title and an optional message, in a way similar to UIAlertView. It automatically fades out after a configurable time interval and, by default, can be dismissed with a tap. It can automatically adapt its size according to the device it's being deployed on, user interface orientation and length of the strings passed to it.

Usage

OLGhostAlertView requires that you include the QuartzCore.framework in your project. Once you have done that, add the OLGhostAlertView files to your project and import the header in the file where you'll be using it, like so:

#import "OLGhostAlertView.h"

After that, here's how you present an OLGhostAlertView:

OLGhostAlertView *ghastly = [[OLGhostAlertView alloc] initWithTitle:@"I am the walrus." message: @"Sitting on a cornflake, waiting for the van to come."];
[ghastly show];

Just like with UIAlertView, the dismissal of the view is handled by the view itself, so there's no need to call anything else. If you do want to dismiss it manually, just call hide on the instance.

Init methods

initWithTitle:message:timeout:dismissible:

Exposes all of the available options.

- (id)initWithTitle:(NSString *)title message:(NSString *)message timeout:(NSTimeInterval)timeout dismissible:(BOOL)dismissible;
Parameters

title
    The string that appears in the view's title label. It is set in a bold, 17pt font.

message
    Descriptive text that provides more details than the title. Set in a regular, 15pt font. Can be nil.

timeout
    Amount of seconds before the view is automatically dismissed.

dismissible
    Whether the view can be dismissed with a tap or not.

initWithTitle:message:

Equivalent to initWithTitle:message:timeout:dismissible:, but assumes default values for timeout (6 seconds) and dismissible (YES).

- (id)initWithTitle:(NSString *)title message:(NSString *)message;

initWithTitle:

Equivalent to initWithTitle:message:timeout:dismissible:, but assumes default values for message (nil) timeout (4 seconds) and dismissible (YES).

- (id)initWithTitle:(NSString *)title;

You're welcome, lazy people.

Properties

position

The vertical position of the view.

@property (nonatomic, strong) OLGhostAlertViewPosition position;

This property controls the origin of the view on the Y axis.

The default value is OLGhostAlertViewPositionBottom.

completionBlock

A block to execute after the instance has been dismissed.

@property (nonatomic, copy) void (^completionBlock)(void);

Known Issues

Here are some current limitations in OLGhostAlertView:

  • The view should be added as a subview of the key window, but it's not (#1)
  • Adding an OLGhostAlertView while displaying a keyboard will cause it to be placed under the keyboard (#3). This can be worked around using the position property. Another way to go around this is described on leberwurstsaft's comment on the issue.

You can find an up-to-date list with full descriptions and discussion at the Issues page.

Help us make this better

We built OLGhostAlertView because we needed it for one of our projects. It's definitely not perfect (hell, it was built by a designer) and it doesn't do everything it could. If you improve it in any way, please send us a pull request. Enjoy!