不止于文字:用CWStatusBarNotification在状态栏展示任意自定义视图
不止于文字:用CWStatusBarNotification在状态栏展示任意自定义视图
CWStatusBarNotification 是一款轻量的 iOS 状态栏通知库(Objective-C),除了让文字消息出现在状态栏区域,还支持在状态栏中展示任意自定义 UIView 视图。只需几行代码,就能做出加载指示器、进度条、头像+文字等轻量、不打断用户操作的通知。
为什么选择状态栏通知 💡
传统 UIAlertController 弹窗会阻塞用户操作,全屏 Toast 又常常遮挡内容,而很多信息(保存成功、同步完成、收到新消息)只需要"轻触达"就够了。
CWStatusBarNotification 的设计哲学正是如此:
- 轻量不打断:出现在状态栏下方,可自动消失,不阻塞交互
- 文字只是起点:任意
UIView都能搬进通知区域 - 高度可定制:背景色、文字色、字体、高度、动画方向均可调
- 接入成本极低:iOS 7.0+,iPhone 与 iPad 均支持
一键安装步骤 📦
CocoaPods(推荐):
pod 'CWStatusBarNotification', '~> 2.3.5'
手动安装:把 CWStatusBarNotification/ 源码文件夹复制到你的项目即可,无任何第三方依赖。
两行代码显示文字通知
引入头文件后,创建对象并调用显示方法:
CWStatusBarNotification *notification = [CWStatusBarNotification new];
[notification displayNotificationWithMessage:@"保存完成" forDuration:1.0];
通知从顶部滑入、停留 1 秒后自动动画消失:
如果想自己控制消失时机,改用 completion: 版本,再在需要时手动关闭:
[notification displayNotificationWithMessage:@"正在同步…" completion:nil];
// …任务完成后
[notification dismissNotification];
核心玩法:在状态栏展示任意自定义视图 ✨
自 2.2.0 版本起,库提供了 displayNotificationWithView: 方法:传入任意 UIView,库会自动把它包进容器并约束到通知区域大小。接口定义见 CWStatusBarNotification.h。
方式一:从 XIB 加载。Demo 工程将自定义视图定义为一个 nib 文件,内含一个转圈指示器和一行文字,参考 CustomView.xib:
UIView *view = [[NSBundle mainBundle] loadNibNamed:@"CustomView" owner:nil options:nil][0];
[notification displayNotificationWithView:view forDuration:2.0];
这正是 Demo 中 "Show Custom View Notification" 按钮的实现,参考 MainViewController.m。
方式二:纯代码视图。用代码组装的视图同样适用:
UIView *loadingView = [MyLoadingView new]; // 任意自定义 UIView
[notification displayNotificationWithView:loadingView forDuration:3.0];
常见使用场景:
| 场景 | 自定义视图内容 |
|---|---|
| 加载反馈 | 旋转的 UIActivityIndicatorView + "正在同步"文字 |
| 进度通知 | UIProgressView 进度条 |
| 消息提示 | 头像 UIImageView + 标题文字 |
| 可交互通知 | 按钮或图标(配合点按回调使用) |
美化通知外观与动画 🎨
所有样式都是显示前设置属性即可:
两种高度样式:默认与状态栏同高;改为"状态栏 + 导航栏"高度后区域更大,适合承载信息更多的自定义视图:
notification.notificationStyle = CWNotificationStyleNavigationBarNotification;
颜色与字体:notificationLabelBackgroundColor(默认取主窗口 tintColor)、notificationLabelTextColor(默认白色)、notificationLabelFont、multiline(是否允许多行文字)。
动画:notificationAnimationInStyle / notificationAnimationOutStyle 分别决定滑入、滑出方向,可取 Top / Bottom / Left / Right 四个值(默认均为从顶部进出);notificationAnimationDuration 控制时长(默认 0.25 秒)。还可选动画是"把内容推开"(Replace)还是"悬浮覆盖"(Overlay)。
点按交互:默认点按即消失。需要点按做事时,设置 notificationTappedBlock(注意:覆写后需自己调用 dismissNotification 才会消失):
notification.notificationTappedBlock = ^{
// 跳转页面、展开菜单…
[notification dismissNotification];
};
常用配置速查表 📋
| 属性 | 说明 | 默认值 |
|---|---|---|
notificationStyle |
高度样式(状态栏 / 状态栏+导航栏) | 状态栏 |
customView |
当前展示中的自定义视图 | nil |
notificationAnimationInStyle / ...OutStyle |
滑入 / 滑出方向 | 顶部 |
notificationAnimationDuration |
动画时长(秒) | 0.25 |
notificationLabelHeight |
自定义通知高度 | 0(自动) |
multiline |
文字是否允许多行 | NO |
notificationTappedBlock |
点按回调 | 点按即消失 |
完整接口文档见 CWStatusBarNotification.h,核心实现逻辑(含自定义视图的包装与约束)在 CWStatusBarNotification.m。
使用注意事项 ⚠️
- 屏幕旋转:两种屏幕方向均可工作,但通知显示期间旋转屏幕暂不完全支持
- 自定义视图尺寸:视图高度由通知样式或
notificationLabelHeight决定,视图内部建议用 Auto Layout 自适应 - 长时任务:建议显示几秒即可,需要常驻时配合
dismissNotification主动关闭 - 支持 ARC,无第三方依赖,可放心引入
写在最后
CWStatusBarNotification 的卖点就是"极简":文字通知两行代码,自定义视图通知三行代码。无论你是需要快速的状态反馈,还是想在状态栏放一个加载指示器做出差异化的通知体验,它都值得放进你的 iOS 项目工具箱。

