转载

一款更 Q 的通知图标控件（OC）IOS开源

本文为CocoaChina网友ningjiayu投稿

一款更Q的通知图标控件。

演示项目

查看并运行 HHBadgeHUDDemo/HHBadgeHUDDemo.xcodeproj

特性

无侵入性 :
轻量 :
易扩展 :

使用方法

###数字图标样式

// 1. 给UIView添加通知图标self.oneView.hh_badge = [HHCountBadge badgeWithCount:99];// 配置外观样式

[(HHCountBadge *)self.oneView.hh_badge applyStyle:^(HHCountBadgeStyle *style) {
    style.bgColor = [UIColor cyanColor];
    style.borderColor = [UIColor redColor];
    style.borderWidth = 1;
    ...
}];// 向左移5， 向下移5[(HHCountBadge *)self.oneView.hh_badge moveByX:-5 Y:5];// 角标+1[(HHCountBadge *)self.oneView.hh_badge increaseWithAnimationType:HHBadgeAnimationPop];// 角标+count[(HHCountBadge *)self.oneView.hh_badge increaseBy:(NSInteger)count animationWithType:HHBadgeAnimationPop];// 角标-1[(HHCountBadge *)self.oneView.hh_badge decreaseWithAnimationType:HHBadgeAnimationPop];// 角标-count[(HHCountBadge *)self.oneView.hh_badge decreaseBy:(NSInteger)count animationWithType:HHBadgeAnimationPop];//

2. 给UIBarButtonItem添加通知图标self.item.hh_badge = [HHCountBadge badgeWithCount:99];

使用方法和上述一样，有一点需要注意，给itemrh2设置此属性时需保证此时item的view属性已被加载，也即不为nil。

###点图标样式

// 1. 给UIView添加通知图标self.oneView.hh_badge = [HHCountBadge badge];// 配置外观样式[(HHDotBadge *)self.oneView.hh_badge applyStyle:^(HHDotBadgeStyle *style) {
    style.bgColor = [UIColor cyanColor];
    style.borderColor = [UIColor redColor];
    style.borderWidth = 1;
    ...
}];// 动画[(HHDotBadge *)self.oneView.hh_badge doAnimationWithType:self.type];// 向左移5， 向下移5[(HHDotBadge *)self.oneView.hh_badge moveByX:-5 Y:5];// 2. 给UIBarButtonItem添加通知图标self.item.hh_badge = [HHCountBadge badge];

使用方法及注意点同上

关键类定义

###支持动画类型

typedef NS_ENUM(NSUInteger, HHBadgeAnimationType) {
    HHBadgeAnimationPop = 0,///< 缩放动画
    HHBadgeAnimationBlink,///< 眨眼动画
    HHBadgeAnimationBump,///< 上下跳动动画
    HHBadgeAnimationNone///< 无};

###点图标样式模型HHDotBadgeStyle

@interface HHDotBadgeStyle : NSObject/// 直径 defalut 15@property (nonatomic, assign)CGFloat badgeDiameter;/// 圆圈的背景颜色@property (nonatomic, strong)UIColor *bgColor;/// 边框颜色@property (nonatomic, strong)UIColor *borderColor;/// 边框宽度@property (nonatomic, assign)CGFloat borderWidth;/// 是否支持QQ的粘性拖拽效果 default NO 此功能暂时未实现 后继版本加入//@property (nonatomic, assign, getter=haveGooEffect)BOOL gooEffect;@end

###数字图标样式模型HHCountBadgeStyle

@interface HHCountBadgeStyle : HHDotBadgeStyle/// 是否自适应大小 default YES@property (nonatomic, assign)BOOL automaticExpansion;/// 是否强制显示0 default NO@property (nonatomic, assign, getter=shouldForcedShowZero)BOOL forceShowZero;/// 数字的颜色@property (nonatomic, strong)UIColor *countColor;/// 数字的字体@property (nonatomic, strong)UIFont *countFont;/// 数字的对齐方式@property (nonatomic, assign)NSTextAlignment countAlignment;@end

###通知图标基类HHBadge

@interface HHBadge : NSObject {
    __weak UIView *_sourceView;
    __weak UIBarButtonItem *_sourceItem;
}/// 快速创建实例+ (instancetype)badge;
- (void)show;
- (void)hide;/// 源视图@property (nonatomic, weak, readonly)UIView *sourceView;/// 源item@property (nonatomic, weak, readonly)UIBarButtonItem *sourceItem;@end

###点样式通知图标HHDotBadge

@interface HHDotBadge : HHBadge/// 配置外观样式- (void)applyStyle:(void (^)(HHDotBadgeStyle *style))maker;/// 配置位置属性- (void)moveByX:(CGFloat)x Y:(CGFloat)y;
- (void)scaleBy:(CGFloat)scale;
- (void)doAnimationWithType:(HHBadgeAnimationType)type;@end

###数字样式通知图标HHCountBadge

@interface HHCountBadge : HHDotBadge/// 快速创建实例+ (instancetype)badgeWithCount:(NSInteger)count;
- (instancetype)initWithCount:(NSInteger)count NS_DESIGNATED_INITIALIZER;/// 配置外观样式- (void)applyStyle:(void (^)(HHCountBadgeStyle *style))maker;
- (void)increaseWithAnimationType:(HHBadgeAnimationType)type;
- (void)increaseBy:(NSInteger)count animationWithType:(HHBadgeAnimationType)type;
- (void)decreaseWithAnimationType:(HHBadgeAnimationType)type;
- (void)decreaseBy:(NSInteger)count animationWithType:(HHBadgeAnimationType)type;/// 数量@property (nonatomic, assign)NSInteger count;@end

###分类

@interface UIView (HHBadgeHUD)@property (nonatomic, strong) __kindof HHBadge *hh_badge;@end@interface UIBarButtonItem (HHBadgeHUD)/// 设置此值的时候确保Item的View属性已被加载@property (nonatomic, strong) __kindof HHBadge *hh_badge;@end

安装

CocoaPods

在 Podfile 中添加 pod 'HHBadgeHUD' 。

执行 pod install 或 pod update 。

导入。

手动安装

下载 HHBadgeHUD 文件夹内的所有内容。

将 HHBadgeHUD 内的源文件添加(拖放)到你的工程。

导入 HHBadgeHUD.h 。

系统要求

该项目最低支持 iOS 6.0 和 Xcode 7.0 。

许可证