不止于文字:用CWStatusBarNotification在状态栏展示任意自定义视图

原创2026-10-31 19:47:061,367 阅读
文章标签:移动开发UI库/组件

不止于文字:用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 秒后自动动画消失:

CWStatusBarNotification iOS状态栏文字通知效果

如果想自己控制消失时机,改用 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;

CWStatusBarNotification状态栏加导航栏高度的自定义通知效果

颜色与字体: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 项目工具箱。

登录后查看全文
CWStatusBarNotification