Skip to content

Latest commit

 

History

History
83 lines (45 loc) · 3.7 KB

README.md

File metadata and controls

83 lines (45 loc) · 3.7 KB
Raw

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.

There are three convenience methods to init OLGhostAlertView:

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:

It's 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:

It's 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.

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)
    If you need this fixed, refer to 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!