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.
Installation
CocoaPods:
pod 'JDStatusBarNotification'
(For infos on cocoapods, have a look at the cocoapods website)
Manually:
- Drag the
JDStatusBarNotification/JDStatusBarNotificationfolder into your project. - 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
+ (void)showProgress:(CGFloat)progress; // Range: 0.0 - 1.0
Showing activity
+ (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:<#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;
}];
Animation Types
JDStatusBarAnimationTypeNoneJDStatusBarAnimationTypeMoveJDStatusBarAnimationTypeBounceJDStatusBarAnimationTypeFade
Progress Bar Positions
JDStatusBarProgressBarPositionBottomJDStatusBarProgressBarPositionCenterJDStatusBarProgressBarPositionTopJDStatusBarProgressBarPositionBelowJDStatusBarProgressBarPositionNavBar
iPhone X behavior
JDStatusBarHeightForIPhoneXHalfJDStatusBarHeightForIPhoneXFullNavBar
I'm @calimarkus on Twitter. Feel free to post a tweet, if you like JDStatusBarNotification.
![[Feature Request] Status Queues](https://avatars.githubusercontent.com/u/35369?v=4)
4.9k Dec 31, 2022
632 Dec 22, 2022
3.7k Dec 25, 2022
704 Dec 17, 2022
3.3k Dec 22, 2022
203 Nov 20, 2022
2 Feb 3, 2022
608 Dec 30, 2022
70 Nov 20, 2022
1.1k Dec 30, 2022
2.5k Jan 3, 2023
3.3k Dec 31, 2022
397 Dec 6, 2022
85 Aug 8, 2020
4.5k Jan 9, 2023
3.8k Dec 20, 2022
11 Jun 6, 2022
794 Nov 29, 2022