HHBadgeHUD

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 21)

一款更Q的通知图标控件

HHBadgeHUD Latest Version Download

Download Latest Version (.zip)

// 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

HHBadgeHUD Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

HHBadgeHUD

HHBadgeHUD Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README