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.
pod 'JDStatusBarNotification'
(For infos on cocoapods, have a look at the cocoapods website)
- Drag the
JDStatusBarNotification/JDStatusBarNotificationfolder into your project. - Add
#include "JDStatusBarNotification.h", where you want to use it
github "calimarkus/JDStatusBarNotification"
(more infos on Carthage here)
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:
JDStatusBarNotification is a singleton. You don't need to initialize it anywhere. Just use the following class methods:
+ (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.
+ (void)dismiss;
+ (void)dismissAfter:(NSTimeInterval)delay;
+ (void)showProgress:(CGFloat)progress; // Range: 0.0 - 1.0
+ (void)showActivityIndicator:(BOOL)show
indicatorStyle:(UIActivityIndicatorViewStyle)style;
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.
+ (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:<#identifier#>
prepare:^JDStatusBarStyle*(JDStatusBarStyle *style) {
// main properties
style.barColor = <#color#>;
style.textColor = <#color#>;
style.font = <#font#>;
// advanced properties
style.animationType = <#type#>;
style.textShadow = <#shadow#>;
style.textVerticalPositionAdjustment = <#adjustment#>;
// progress bar
style.progressBarColor = <#color#>;
style.progressBarHeight = <#height#>;
style.progressBarPosition = <#position#>;
return style;
}];
JDStatusBarAnimationTypeNoneJDStatusBarAnimationTypeMoveJDStatusBarAnimationTypeBounceJDStatusBarAnimationTypeFade
JDStatusBarProgressBarPositionBottomJDStatusBarProgressBarPositionCenterJDStatusBarProgressBarPositionTopJDStatusBarProgressBarPositionBelowJDStatusBarProgressBarPositionNavBar
JDStatusBarHeightForIPhoneXHalfJDStatusBarHeightForIPhoneXFullNavBar
I'm @calimarkus on Twitter. Feel free to post a tweet, if you like JDStatusBarNotification.
