Need help with JDStatusBarNotification?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

calimarkus
3.8K Stars 542 Forks MIT License 233 Commits 20 Opened issues

Description

[iOS] Easy, customizable notifications displayed on top of the statusbar. With progress and activity. iPhone X ready.

Services available

!
?

Need anything else?

Contributors list

No Data

JDStatusBarNotification

Show messages on top of the status bar. Customizable colors, font and animation. Supports progress display and can show an activity indicator. iOS 6+ support, iPhone X support. Please open a Github issue, if you think anything is missing or wrong.

Animation

Animation

Screenshots

Installation

CocoaPods:

pod 'JDStatusBarNotification'

(For infos on cocoapods, have a look at the cocoapods website)

Manually:

  1. Drag the
    JDStatusBarNotification/JDStatusBarNotification
    folder into your project.
  2. Add
    #include "JDStatusBarNotification.h"
    , where you want to use it

Carthage:

github "calimarkus/JDStatusBarNotification"

(more infos on Carthage here)

Beware: App Rejections

Some people informed me, that their apps got rejected for using status bar overlays (for violating 10.1/10.3). All cases I'm aware of are listed here:

Usage

JDStatusBarNotification is a singleton. You don't need to initialize it anywhere. Just use the following class methods:

Showing a notification

+ (JDStatusBarView*)showWithStatus:(NSString *)status;
+ (JDStatusBarView*)showWithStatus:(NSString *)status
                      dismissAfter:(NSTimeInterval)timeInterval;

The return value will be the notification view. You can just ignore it, but if you need further customization, this is where you can access the view.

Dismissing a notification

+ (void)dismiss;
+ (void)dismissAfter:(NSTimeInterval)delay;

Showing progress

Progress animation

+ (void)showProgress:(CGFloat)progress;  // Range: 0.0 - 1.0

Showing activity

Activity screenshot

+ (void)showActivityIndicator:(BOOL)show
               indicatorStyle:(UIActivityIndicatorViewStyle)style;

Showing a notification with alternative styles

Included styles:

Use them with the following methods:

+ (JDStatusBarView*)showWithStatus:(NSString *)status
                         styleName:(NSString*)styleName;

  • (JDStatusBarView*)showWithStatus:(NSString *)status
                    dismissAfter:(NSTimeInterval)timeInterval
                       styleName:(NSString*)styleName;

To present a notification using a custom style, use the

identifier
you specified in
addStyleNamed:prepare:
. See Customization below.

Customization

+ (void)setDefaultStyle:(JDPrepareStyleBlock)prepareBlock;

  • (NSString*)addStyleNamed:(NSString*)identifier

                 prepare:(JDPrepareStyleBlock)prepareBlock;

The

prepareBlock
gives you a copy of the default style, which can be modified as you like:
[JDStatusBarNotification addStyleNamed:
                             prepare:^JDStatusBarStyle*(JDStatusBarStyle *style) {

                             // main properties
                             style.barColor = ;
                             style.textColor = ;
                             style.font = ;

                             // advanced properties
                             style.animationType = ;
                             style.textShadow = ;
                             style.textVerticalPositionAdjustment = ;

                             // progress bar
                             style.progressBarColor = ;
                             style.progressBarHeight = ;
                             style.progressBarPosition = ;

                             return style;
                         }];

Animation Types

  • JDStatusBarAnimationTypeNone
  • JDStatusBarAnimationTypeMove
  • JDStatusBarAnimationTypeBounce
  • JDStatusBarAnimationTypeFade

Progress Bar Positions

  • JDStatusBarProgressBarPositionBottom
  • JDStatusBarProgressBarPositionCenter
  • JDStatusBarProgressBarPositionTop
  • JDStatusBarProgressBarPositionBelow
  • JDStatusBarProgressBarPositionNavBar

iPhone X behavior

  • JDStatusBarHeightForIPhoneXHalf
  • JDStatusBarHeightForIPhoneXFullNavBar

Twitter

I'm @calimarkus on Twitter. Feel free to post a tweet, if you like JDStatusBarNotification.

TweetButton

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.