WZLBadge is a tool to add or clear badge for any UIViews, which is written in Objective-C, supporting iOS5 or above, supporting portrait and landscape device orientation.
The code is implemented by the way of category for UIView, thus, it is very easy to use.
At this version, three badge style are supported:
- WBadgeStyleRedDot
- WBadgeStyleNumber
- WBadgeStyleNew
Three animation types are supported:
- WBadgeAnimTypeNone(by default)
- WBadgeAnimTypeScale
- WBadgeAnimTypeShake
- WBadgeAnimTypeBreathe
- WBadgeAnimTypeBounce
Here are examples for WZLBadge(just show static picture without gif here):
Method1： Drag the
WZLBadge
folder into your project.
Method2: Use CocoaPods to install automaticlly:
pod 'WZLBadge'
- Xcode 6
- iOS5 or above
- ARC (or MRC, but project setting is necessary)
- Add the following import to the top of the file:
import "WZLBadgeImport.h"
- Use the following to display badge easily:
[someView showBadgeWithStyle:WBadgeStyleRedDot value:0 animationType:WBadgeAnimTypeShake]; [someView showBadgeWithStyle:WBadgeStyleNumber value:99 animationType:WBadgeAnimTypeShake];
or simply call interface:[- showBadge]
- Use the following to hide badge easily:
[someView clearBadge];
4.Use the following to resume badge when it has been hidden:
[someView resumeBadge];
Feel free to customize badge size, position, animation style or anything else.
WZLBadge provides easy way to customize its style.:
//set background color. red color by default
view.badgeBgColor = [UIColor purpleColor];
//set badge position. right-top corner of view by default
view.badgeCenterOffset = CGPointMake(-8, 0);
//set badge foreground color. white color by default
view.badgeTextColor = [UIColor whiteColor];
//...
Do you have any questions or idea? My email is:
Or you can find some more info at my blog in cnblogs.com:
如果你在天朝，可以查看中文博客地址： http://www.cnblogs.com/wengzilin/p/4633937.html
This project will be update continually. Therefore, fork or star would be suggested.
I wish it to be an ultimat solution for UIView badge in iOS.
Zilin Weng(翁子林) https://github.com/weng1250
- jfuellert https://github.com/jfuellert
- zhangao0086 https://github.com/zhangao0086
Feel free to open an issue or pull request, if you need help or there is a bug.
v1.2.6 2017.4.20 Bugs were fixed. Enable setting badge properties before bage initialization.
v.1.2.5 2017.3.1 fix bug 'when showing TabbarItem bage, badge is covered by tabbarItem icon'
v1.2.3 2016.2.15 1.Enable resume badge when badge has been cleard(removed)
V1.2.2 2015.12.18 1.Enable badge font customization 2.code warning removed
V1.2 2015.09.25 1.UITabBarItem badge is supproted; 2.Enable change badge properties when badge is showing; 3.Other code optimization.
V1.1 2015.08.12
- UIBarButtonItem badge is supported. UIBarButtonItem is kind of NSObject and its displayed view is invisiable. This version makes usage of UIBarButtonItem badge as to UIView.
- Slight adjustment for code structure to fit future extension.
- Other code optimization.
V1.0 at 2015.06.16
Base functions are completed, which is able to meet most of requirements.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.