Skip to content
A way to quickly add a notification badge icon to any view. Make any UIView a full fledged animated notification center.
Branch: master
Clone or download
Latest commit 509e162 Jun 13, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Create FUNDING.yml May 31, 2019
BadgeHub Hotfix/func access modifier (#8) Jun 13, 2019
Example Change access modifier Jun 13, 2019
.gitignore Initial commit May 31, 2019
.travis.yml Update .travis.yml May 31, 2019
BadgeHub.podspec
LICENSE Initial commit May 31, 2019
README.md Fix typo May 31, 2019
_Pods.xcodeproj Initial commit May 31, 2019

README.md

BadgeHub

A way to quickly add a notification badge icon to any view.

CI Status Version License Platform Donate

Blink Bump Pop Custom setCircle showCount mix hideCount

Demo/Example

For demo:

$ pod try BadgeHub

To run the example project, clone the repo, and run pod install from the Example directory first.

$ cd Example
$ pod install

If you don't have CocoaPods installed, grab it with [sudo] gem install cocoapods.

$ open BadgeHub.xcworkspace

Requirements

  • iOS 10.0 or later
  • Swift 5+
  • Xcode 10+

Installation

CocoaPods

BadgeHub is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'BadgeHub'

Manual Installation

Just drag the BadgeHub.swift files into your project.

Usage

Initialization

let hub = BadgeHub(view: yourView) // Initially count set to 0

Increase count value by 1

hub.increment()

Increase count by some int value

hub.increment(by: Int)

Decrease count value by 1

hub.decrement()

Decrease count by some int value

hub.decrement(by: Int)

Set count to static integer value

hub.setCount(newCount: Int)

Combine actions

mix

hub.increment()
hub.pop()
hub.blink()

Don't forget to import BadgeHub

Customization

Change the color of the notification circle

setCircleColor

hub.setCircleColor(_ circleColor: UIColor?, label labelColor: UIColor?)

Change the border color and border width of the circle

Custom

hub.setCircleBorderColor(_ color: UIColor?, borderWidth width: CGFloat)

Set the frame of the notification circle relative to the view

setCircle

hub.setCircleAtFrame(_ frame: CGRect)

Move the circle (left/right or up/down)

hub.moveCircleBy(x: CGFloat, y: CGFloat)

Changes the size of the circle. setting a scale of 1 has no effect

hub.scaleCircleSize(by scale: CGFloat)

Hide the count (Blank Bedge)

hideCount

hub.hideCount()

Show count again on the bedge

showCount

hub.showCount()

Animations

Pop out and pop in the bedge

Pop

hub.pop()

Make bedge blinking

Blink

hub.blink()

Animation that jumps similar to OSX dock icons

Bump

hub.bump()

TROUBLESHOOTING

Notification isn't showing up!

  • If the hub value is < 1, the circle hides. Try calling increment().
  • Make sure the view you set the hub to is visible (i.e. did you call self.view.addSubview(yourView)?).
  • Make sure you didn't call hideCount() anywhere. Call showCount() to counter this.

It isn't incrementing / decrementing properly!

  • Any count < 1 doesn't show up. If you need help customizing this, reach out to me!

The circle is in a weird place

  • If you want to resize the circle, use scaleCircleSize(by scale: CGFloat). 0.5 will give you half the size, 2 will give you double.
  • If the circle is just a few pixels off, use moveCircleBy(x: CGFloat, y: CGFloat). This shifts the circle by the number of pixels given.
  • If you want to manually set the circle, call setCircleAtFrame(_ frame: CGRect) and give it your own CGRect.

Something else isn't working properly

Author

Jogendra Kumar

DONATION

If this project help you reduce time to develop or you loved this project, you can give me a cup of coffee :)

paypal

License

BadgeHub is available under the MIT license. See the LICENSE file for more info.

You can’t perform that action at this time.