PPBadgeView完整概览:这款iOS自定义Badge角标组件凭什么广受追捧?

原创2026-10-25 18:58:291,407 阅读

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 工程(四个演示页面)

两个值得细看的示例:

常见问题 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、导航栏或自定义视图寻找一个靠谱的角标方案,不妨把这几个文件拖进工程试试。

登录后查看全文
PPBadgeView