Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cwRichardKim/RKNotificationHub
Make any UIView a full fledged notification center
https://github.com/cwRichardKim/RKNotificationHub
Last synced: 3 months ago
JSON representation
Make any UIView a full fledged notification center
- Host: GitHub
- URL: https://github.com/cwRichardKim/RKNotificationHub
- Owner: cwRichardKim
- License: mit
- Created: 2014-10-01T17:36:18.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2018-11-02T16:54:46.000Z (about 6 years ago)
- Last Synced: 2024-04-24T14:15:41.615Z (6 months ago)
- Language: Objective-C
- Homepage:
- Size: 476 KB
- Stars: 3,041
- Watchers: 72
- Forks: 327
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-cocoa - RKNotificationHub
- awesome-ios-star - RKNotificationHub - Make any UIView a full fledged notification center. (UI / Font)
- awesome-ios - RKNotificationHub - Make any UIView a full fledged notification center. (UI / Font)
README
RKNotificationHub
=================
A way to quickly add a notification icon to a UIView (iOS6 and up). [Support](http://cwrichardkim.com)
Code:
``` objc
RKNotificationHub* hub = [[RKNotificationHub alloc]initWithView:yourView]; // sets the count to 0
[hub increment]; // increments the count to 1, making the notification visible
```
### Pod
```
pod 'RKNotificationHub'
```
### USAGE
``` objc
[hub increment];
```
``` objc
-(void)increment;
-(void)incrementBy:(int)amount;
-(void)decrement;
-(void)decrementBy:(int)amount;
@property (nonatomic, assign) int count; //%%% set to a certain number
```
__Combine Actions!__
``` objc
[hub increment];
[hub pop];
```
### CUSTOMIZE
``` objc
//%%% COLOR
[hub setCircleColor:[UIColor colorWithRed:0.98 green:0.66 blue:0.2 alpha:1]
labelColor:[UIColor whiteColor]];
```
```objc
//%%% CIRCLE FRAME
[hub setCircleAtFrame:CGRectMake(-10, -10, 30, 30)]; //frame relative to the view you set it to
//%%% MOVE FRAME
[hub moveCircleByX:-5 Y:5]; // moves the circle 5 pixels left and down from its current position
//%%% CIRCLE SIZE
[hub scaleCircleSizeBy:2]; // doubles the size of the circle, keeps the same center
```
``` objc
//%%% BLANK BADGE
[hub hideCount];
/* shoutout to imkevinxu for this suggestion */
```
### 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!**
* I've written it so that 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 `[scaleCircleSizeBy:]`. 0.5 will give you half the size, 2 will give you double
* If the circle is just a few pixels off, use `[moveCircleByX: Y:]`. This shifts the circle by the number of pixels given
* If you want to manually set the circle, call `[setCircleAtFrame:]` and give it your own CGRect
**Something else isn't working properly**
* Send me a tweet @cwRichardKim with #RKNotificationHub so that other people can search these issues too
* Use github's issue reporter on the right
* Send me an email [email protected] (might take a few days)
### Updates
* 1.0.0 first release with cocoapod
* 1.0.1 cocoapod allows iOS 7.0
* 1.0.2 added "hideCount", "showCount", and "count" methods, allowing indeterminate badges with no number
* 1.0.5 added bubble expansion for larger numbers [(gif)](http://i.imgur.com/cpQuShT.gif)
* 2.0.0 changed count to `NSUInteger` (removed support for negative counts), made local constants `static const`
* 2.0.1 iOS 6 compatability
* 2.0.2 changed count back to 'int' for better swift compatability
* 2.0.4 fixed cocoapod update issue
### Areas for Improvements / involvement
* A mechanism for adding a custom animation
* Singleton option