base on Highly customizable & feature rich notifications. Interactive dismiss. Custom Views. SwiftUI. Tap-to-hold. Progress. Written in Swift, compatible for ObjC! # JDStatusBarNotification [](https://swiftpackageindex.com/calimarkus/JDStatusBarNotification) Highly customizable & feature rich notifications displayed below the status bar / notch / Island. Written in Swift, compatible for Obj-C! Please open a [Github issue](https://github.com/calimarkus/JDStatusBarNotification/issues), if you think anything is missing or wrong. * Customizable colors, fonts & animations with multiple built-in styles * Interactive & interuptable Drag-to-Dismiss * Adaptive, dynamic layout * Built-in pill-style or full-width layouts * Pill width matches the presented text (customizable) * Works on notch and no-notch devices * Works in landscape & portrait * Built-in features (automatic layout): * Title, subtitle and left-hand-views (e.g. Icons) * An activity indicator * A progress bar * Custom views (UIView or SwiftUI View) Some examples of the possibilities - the pill style is the default:  Full-Width styles in action - the above pill style supports the same features and animations: | Drag to dismiss | Activity & Progress Bars | Custom styles | | ------------- | ------------- | ------------- | |  |  |  | | Landscape apps (device rotation also supported) | | ------------- | |  | ## Installation - [**SPM (Swift Package Manager):**](https://github.com/apple/swift-package-manager) - Xcode -> File -> Add packages: `[email protected]:calimarkus/JDStatusBarNotification.git` - Importing: - In Swift: `import JDStatusBarNotification` - In ObjC: `@import JDStatusBarNotification;` - [**CocoaPods:**](https://guides.cocoapods.org) - `pod 'JDStatusBarNotification'` - [**Carthage:**](https://github.com/Carthage/Carthage) - `github "calimarkus/JDStatusBarNotification"` - **Manually:** - Copy the `JDStatusBarNotification/JDStatusBarNotification` folder into your project. ## Documentation Find the [class documentation](http://calimarkus.github.io/JDStatusBarNotification/documentation/jdstatusbarnotification) hosted on Github. ## Changelog See [CHANGELOG.md](CHANGELOG.md) ## Getting started All examples here are written in Swift. But everything can be called from Objective-C too. Also checkout the example project, which has many examples and includes a convenient style editor to build a custom style. ### SwiftUI state-driven presentation #### Showing a simple text notification ```swift var body: some View { Button("Present/dismiss") { isPresented.toggle() } .notification(title: "Hello World", isPresented: $isPresented) } ``` #### Showing a styled notification with subtitle, activity and/or progress ```swift var body: some View { Button("Present/dismiss") { isPresented.toggle() } .notification(title: "A text", subtitle: "with a little subtitle.", isPresented: $isPresented, isShowingActivity: $activity, // toggles an activity indicator on/off progress: $progress, // sets the percentage of a progress bar includedStyle: .success) // picks a predefined style } ``` #### Showing a custom view as notification ```swift var body: some View { Button("Present/dismiss") { isPresented.toggle() } .notification(isPresented: $isPresented) { Text("👋 Hi there!") .font(.subheadline) .foregroundStyle(.white) } } ``` ### Manual presentation (from Swift or ObjC) #### Showing a text notification ```swift NotificationPresenter.shared.present("Hello World") // with completion NotificationPresenter.shared.present("Hello World") { presenter in // ... } ``` #### Dismissing a notification ```swift NotificationPresenter.shared.dismiss() // with completion NotificationPresenter.shared.dismiss(after: 0.5) { presenter in // ... } ``` #### Showing activity ```swift NotificationPresenter.shared.present("") NotificationPresenter.shared.displayActivityIndicator(true) ```  #### Showing a custom left view ```swift let image = UIImageView(image: UIImage(systemName: "gamecontroller.fill")) NotificationPresenter.shared.present("Player II", subtitle: "Connected") NotificationPresenter.shared.displayLeftView(image) ```  #### Showing progress ```swift NotificationPresenter.shared.present("Animating Progress…") { presenter in presenter.animateProgressBar(to: 1.0, duration: 0.75) { presenter in presenter.dismiss() } } // or set an explicit percentage manually (without animation) NotificationPresenter.shared.displayProgressBar(at: 0.0) ```  #### Using other included styles There's a few included styles you can easily use with the following API: ```swift NotificationPresenter.shared.present("Yay, it works!", includedStyle: .success) ```  #### Showing a custom SwiftUI view (Swift only) ```swift NotificationPresenter.shared.presentSwiftView { Text("Hi from Swift!") } // with completion NotificationPresenter.shared.presentSwiftView { Text("Hi from Swift!") } completion: { presenter in // ... } ``` #### Using a custom UIView (Swift or ObjC) If you want full control over the notification content and styling, you can use your own custom UIView. ```swift // present a custom view let button = UIButton(type: .system, primaryAction: UIAction { _ in NotificationPresenter.shared.dismiss() }) button.setTitle("Dismiss!", for: .normal) NotificationPresenter.shared.presentCustomView(button) ``` | Light Mode | Dark Mode | | --- | --- | |  |  | ## Customization You have the option to easily create & use fully customized styles. ### From SwiftUI Modify the style in a `NotificationStyleClosure`: ```swift var body: some View { Button("Present/dismiss") { isPresented.toggle() } .notification(isPresented: $isPresented, style: { let s = $0.backgroundStyle s.backgroundColor = .black s.pillStyle.minimumWidth = 150 s.pillStyle.height = 44 }) { Text("👋 Hi there!") .font(.subheadline) .foregroundStyle(.white) } } ``` ### Manually The ``PrepareStyleClosure`` provides a copy of the default style, which can then be modified. See the ``StatusBarNotificationStyle`` API for all options. ```swift // update default style NotificationPresenter.shared.updateDefaultStyle { style in style.backgroundStyle.backgroundColor = .red style.textStyle.textColor = .white style.textStyle.font = UIFont.preferredFont(forTextStyle: .title3) // and many more options return style } // set a named custom style NotificationPresenter.shared.addStyle(named: "xxx") { style in // ... return style } ``` ### Style Editor Or checkout the example project, which contains a full style editor. You can tweak all customization options within the app, see the changes live and even export the configuration code for the newly created style to easily use it in your app.  ### Background Styles There's two supported `StatusBarNotificationBackgroundType`'s: ```swift enum { /// The background is a floating pill around the text. /// The pill size and appearance can be customized. This is the default. .pill, /// The background covers the full display width and the full status bar + navbar height. .fullWidth } ``` ### Animation Types The supported `StatusBarNotificationAnimationType`'s: ```swift enum { /// Slide in from the top of the screen and slide /// back out to the top. This is the default. .move, /// Fade-in and fade-out in place. No movement animation. .fade, /// Fall down from the top and bounce a little bit, before /// coming to a rest. Slides back out to the top. .bounce } ``` ## Troubleshooting ### No notifications are showing up If your app uses a `UIWindowScene` the `NotificationPresenter` needs to know about it before you present any notifications. The library attempts to find the correct WindowScene automatically, but that might fail. If it fails no notifications will show up at all. You can explicitly set the window scene to resolve this: ```swift NotificationPresenter.shared().setWindowScene(windowScene) ``` ## Twitter I'm [@calimarkus](http://twitter.com/calimarkus) on Twitter. Feel free to [post a tweet](https://twitter.com/intent/tweet?button_hashtag=JDStatusBarNotification&text=Simple%20and%20customizable%20statusbar%20notifications%20for%20iOS!%20Check%20it%20out.%20https://github.com/calimarkus/JDStatusBarNotification&via=calimarkus), if you like JDStatusBarNotification. [](https://twitter.com/intent/tweet?button_hashtag=JDStatusBarNotification&text=Simple%20and%20customizable%20statusbar%20notifications%20for%20iOS!%20Check%20it%20out.%20https://github.com/calimarkus/JDStatusBarNotification&via=calimarkus) ## Credits Originally based on `KGStatusBar` by Kevin Gibbon ", Assign "at most 3 tags" to the expected json: {"id":"11237","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"