HHBadgeHUD

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 21 Open GitHub ↗

一款更Q的通知图标控件

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

简介
==============
一款更Q的通知图标控件。<br/>

演示项目
==============
查看并运行 `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];
    使用方法和上述一样， 有一点需要注意，给item设置此属性时需保证此时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

1. 在 Podfile 中添加 `pod 'HHBadgeHUD'`。
2. 执行 `pod install` 或 `pod update`。
3. 导入 \<HHBadgeHUD/HHBadgeHUD.h\>。

### 手动安装

1. 下载 HHBadgeHUD 文件夹内的所有内容。
2. 将 HHBadgeHUD 内的源文件添加(拖放)到你的工程。
3. 导入 `HHBadgeHUD.h`。

系统要求
==============
该项目最低支持 `iOS 6.0` 和 `Xcode 7.0`。

许可证
==============
HHBadgeHUD 使用 MIT 许可证，详情见 LICENSE 文件。

HHBadgeHUD

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README