PPBadgeView完整概览:这款iOS自定义Badge角标组件凭什么广受追捧?
PPBadgeView完整概览:这款iOS自定义Badge角标组件凭什么广受追捧?
PPBadgeView 是一款轻量免费的 iOS 自定义 Badge 角标组件,支持给 UIView、UITabBarItem、UIBarButtonItem 及其子类添加数字角标、文本角标和小圆点,同时提供 Objective-C 与 Swift 两套接口,是 iOS 开发中实现小红点提示的高人气开源方案。
一分钟了解 PPBadgeView:它能做什么?
在 iOS 应用里,"小红点 / 数字角标"是最常见的消息提示方式:TabBar 上的 99+ 未读数、导航栏右侧的红点、列表单元格旁边的提醒数字……
但原生 UIKit 只给了 UITabBarItem.badgeValue 这一个"官方入口",它仅支持纯文本、样式无法自定义,而且 UIBarButtonItem 和自定义 UIView 根本没有官方角标能力。
PPBadgeView 解决的正是这个痛点:
| 场景 | 原生方案 | PPBadgeView |
|---|---|---|
| TabBar 图标加角标 | 仅 badgeValue 文本 |
✅ 数字/文本/圆点,可换色、换大小 |
| 导航栏按钮加角标 | ❌ 无官方支持 | ✅ 一行代码搞定 |
| 自定义 UIView 加角标 | ❌ 需自己造轮子 | ✅ 一行代码搞定 |
| 双语言项目混用 | — | ✅ Objective-C / Swift 接口各一套 |
它的核心实现是一个基于 UIControl 的 PPBadgeControl.h,再通过对 UIView、UITabBarItem、UIBarButtonItem 的 Category 扩展(如 UIView+PPBadgeView.h)把角标能力"贴"到任意控件上,Swift 侧则通过 PPBadgeView.swift 中的 pp 属性提供流畅的链式写法。
广受追捧的三大理由
1️⃣ 覆盖面广,一套 API 通吃三类控件
无论目标是普通视图、Tab 栏项还是导航栏按钮,API 命名完全一致,学会一处、处处适用,迁移成本几乎为零。
2️⃣ 双语言原生支持,ObjC 与 Swift 项目都能用
仓库为两种语言各提供独立源码目录,CocoaPods 也分别发布了两个 Pod,混编项目无需任何适配:
- Objective-C 项目:
pod 'PPBadgeView' - Swift 项目:
pod 'PPBadgeViewSwift'
对应描述文件见 PPBadgeView.podspec 与 PPBadgeViewSwift.podspec,当前版本均为 3.1.0。
3️⃣ 极轻量、零第三方依赖
Pod 声明只依赖 UIKit 系统框架,要求 iOS 8+、Xcode 8+,引入后基本不增加包体积。MIT 协议,可放心用于商业项目(见 LICENSE)。
API 功能清单:三行代码加上角标
常用 API 一览(Objective-C / Swift 两种写法对照):
| 功能 | Objective-C | Swift |
|---|---|---|
| 添加文本角标(默认右上角、红色、18pts) | pp_addBadgeWithText:@"99+" |
pp.addBadge(text: "99+") |
| 添加数字角标 | pp_addBadgeWithNumber:1 |
pp.addBadge(number: 1) |
| 添加纯色小圆点(默认 8pts) | pp_addDotWithColor:nil |
pp.addDot() |
| 设置角标高度(宽度按比例联动) | pp_setBadgeHeight:25 |
pp.setBadge(height: 21) |
| 设置偏移量微调位置 | pp_moveBadgeWithX:-7 Y:5 |
pp.moveBadge(x: -7, y: 5) |
| 设置伸缩方向 | pp_setBadgeFlexMode:... |
pp.setBadge(flexMode: .head) |
| 显示 / 隐藏 | pp_showBadge / pp_hiddenBadge |
pp.showBadge() / pp.hiddenBadge() |
| 数字增减(仅纯数字角标可用) | pp_increase / pp_decrease(另有 By: 变体) |
pp.increase() / pp.decrease() |
Swift 项目里的典型写法只需几行:
// 给导航栏左侧按钮加数字角标
navigationItem.leftBarButtonItem?.pp.addBadge(number: 1)
// 点按钮时让角标数字 +1
pp.increase()
💡 数字角标减到 0 时会自动隐藏,无需手动控制显隐,适合未读数这类"归零即消失"的提示。
三种伸缩模式:角标长在哪一侧?
文本角标的宽度是动态的,PPBadgeView 用 flexMode 控制它向哪边"生长":
| 模式 | 方向示意 | 适用场景 |
|---|---|---|
.head(左伸缩) |
<==● |
导航栏右侧按钮,角标向左展开不越界 |
.tail(右伸缩,默认) |
●==> |
大多数控件的右上角 |
.middle(左右伸缩) |
<=●=> |
想让角标始终居中于锚点时 |
枚举定义可参考 PPBadgeControl.h,Swift 侧对应 PPBadgeView.swift。
安装步骤速览:三种方式任选
方式一:手动导入
- Objective-C:把 PPBadgeView/objc/ 目录下的
.h与.m文件拖入工程,#import "PPBadgeView.h"即可; - Swift:把 PPBadgeView/swift/ 目录下的
.swift文件拖入工程即可。
方式二:CocoaPods(最常用)
pod 'PPBadgeView' # Objective-C 项目
pod 'PPBadgeViewSwift' # Swift 项目
方式三:Carthage(Swift)
在 Cartfile 中添加 github "jkpang/PPBadgeView" ~> 3.0.0,再执行 carthage update --platform iOS。
📌 小贴士:如果
pod search搜不到最新版本,在终端执行pod setup刷新本地 spec 镜像缓存后再搜索即可。
文件结构与 Demo 导航
想深入源码或看实际效果,仓库里有完整的双语言示例工程:
| 目录 | 说明 |
|---|---|
| PPBadgeView/objc/ | Objective-C 组件源码(8 个文件,含 Category 扩展) |
| PPBadgeView/swift/ | Swift 组件源码(5 个文件) |
| PPBadgeViewObjc/ | ObjC 完整 Demo 工程(TabBar + 列表页) |
| PPBadgeViewSwift/ | Swift 完整 Demo 工程(四个演示页面) |
两个值得细看的示例:
- PPTabBarController.m:演示给
UITabBarItem加 "99+" 角标; - PPViewController1.swift:演示导航栏按钮角标的增减、偏移与
.head伸缩模式。
常见问题 FAQ
Q1:为什么 Demo 里给 TabBarItem 加角标要延迟 0.01 秒?
因为在 viewDidLoad 中部分系统版本还拿不到 tabBarItem / UIBarButtonItem 实例。Demo 用延时只为演示效果;实际开发中角标通常在收到网络数据或推送后才显示,天然晚于视图创建,不受影响。详见 PPViewController1.swift 中的注释。
Q2:increase / decrease 为什么对 "99+" 不生效?
这两个接口只适用于纯数字角标——它读取当前文本并做整数运算,"99+" 这类文本角标请直接调用 addBadge(number:) 重新赋值。
Q3:如何自定义字体、颜色?
直接改 badgeView 的属性即可,例如 Swift 中:
pp.badgeView.textLabel.font = UIFont.systemFont(ofSize: 13)
pp.badgeView.textLabel.textColor = .blue
写在最后
PPBadgeView 用极简的 API 覆盖了 iOS 中几乎所有"加个小红点"的诉求:双语言、零依赖、一行代码出效果,再配合可自定义的高度、偏移、伸缩方向与样式,这也是它长期位居 iOS 角标类组件热门榜的原因。如果你正在为 TabBar、导航栏或自定义视图寻找一个靠谱的角标方案,不妨把这几个文件拖进工程试试。