UIStatusBar正确使用姿势(小结)2017.10.15更新

本期开发中, 遇到要修改特定UIViewController的UIStatusBar.
项目用的是:

[[UIApplication sharedApplication] setStatusBarStyle:UIStatusBarStyleLightContent];

这种方法已经废弃.

- (void)setStatusBarStyle:(UIStatusBarStyle)statusBarStyle animated:(BOOL)animated NS_DEPRECATED_IOS(2_0, 9_0, "Use -[UIViewController preferredStatusBarStyle]") __TVOS_PROHIBITED;

虽然还能用,但是在UIViewController生命周期哪个时间调用才是正确,而不会影响到其他UIViewController?

就在这时懒癌发作, 决定改成系统推荐的方式来管理UIStatusBar.

即UIViewController需要时,重写以下方法:

- (UIStatusBarStyle)preferredStatusBarStyle NS_AVAILABLE_IOS(7_0) __TVOS_PROHIBITED; // Defaults to UIStatusBarStyleDefault

- 第一步,修改info.plist文件

找到View controller-based status bar appearance选项,如下图:

info.plist

将值改为YES,或者直接删除改选项(默认值就是YES).

- 第二步,实现'preferredStatusBarStyle'方法

- (UIStatusBarStyle)preferredStatusBarStyle{
    return UIStatusBarStyleLightContent;
}

Run, 然并卵, 打个断点, 发现并没有调用.

搜索发现:

Stack Overflow

还是没用.
后面事实证明, 完全多余. 如果你Xcode有相关代码可以安心删除.

诸如UINavigationController, UITabBarController 等系统UIViewController容器类, Apple会自己搞定,不用开发者操心.

// Override to return a child view controller or nil. If non-nil, that view controller's status bar appearance attributes will be used. If nil, self is used. Whenever the return values from these methods change, -setNeedsUpdatedStatusBarAttributes should be called.
#if UIKIT_DEFINE_AS_PROPERTIES
@property(nonatomic, readonly, nullable) UIViewController *childViewControllerForStatusBarStyle NS_AVAILABLE_IOS(7_0) __TVOS_PROHIBITED;
@property(nonatomic, readonly, nullable) UIViewController *childViewControllerForStatusBarHidden NS_AVAILABLE_IOS(7_0) __TVOS_PROHIBITED;
#else
- (nullable UIViewController *)childViewControllerForStatusBarStyle NS_AVAILABLE_IOS(7_0) __TVOS_PROHIBITED;
- (nullable UIViewController *)childViewControllerForStatusBarHidden NS_AVAILABLE_IOS(7_0) __TVOS_PROHIBITED;
#endif

但是这两个API的确提醒了我, 应该是Child ViewController的问题.

于是从RootViewController开始查找, 发现 RootViewController 是一个UIViewController, 而UITabBarController是作为他的一个Child ViewController并完全盖住它. 估计就是这里传递断了.

于是新建一个RootViewController分类:

//这里RootViewController 是LMAppMainVC
//tabBarVC是UITabBarController

@implementation LMAppMainVC (LMStatusBarStyle)

- (UIViewController *)childViewControllerForStatusBarStyle{
    return self.tabBarVC;
}

- (UIViewController *)childViewControllerForStatusBarHidden{
    return self.tabBarVC;
}
@end

Run, 然后这次OK.棒棒哒.

简单讲讲, 从App启动开始UIStatusBar是怎么展示的.

- App启动时的样式,在下面这里设置:
App启动UIStatusBar
- App启动后,是一个传递链条.

首先RootViewController开始,如果RootViewController是系统容器类的ViewController, 如UINavigationController, UITabBarController 等会自动传递到当前正在显示的ViewController.

如果ViewController实现了以下方法:

- (nullable UIViewController *)childViewControllerForStatusBarStyle NS_AVAILABLE_IOS(7_0) __TVOS_PROHIBITED;
- (nullable UIViewController *)childViewControllerForStatusBarHidden NS_AVAILABLE_IOS(7_0) __TVOS_PROHIBITED;

会按照实现的方法来传递.

主要是,当我们自己添加的Child ViewController, 就需要我们去实现这两个方法来往上传递.

当Present一个ViewController的时候,系统也会自己往上传递,不需要我们操心.

当然我们要注意non-full screen的情况,如下:

// This controls whether this view controller takes over control of the status bar's appearance when presented non-full screen on another view controller. Defaults to NO.
@property(nonatomic,assign) BOOL modalPresentationCapturesStatusBarAppearance NS_AVAILABLE_IOS(7_0) __TVOS_PROHIBITED;

当已经无法再向上传递的时候, 系统会调用当前ViewController的下面两个方法,来展示UIStatusBar.

- (UIStatusBarStyle)preferredStatusBarStyle NS_AVAILABLE_IOS(7_0) __TVOS_PROHIBITED; // Defaults to UIStatusBarStyleDefault
- (BOOL)prefersStatusBarHidden NS_AVAILABLE_IOS(7_0) __TVOS_PROHIBITED; // Defaults to NO
// Override to return the type of animation that should be used for status bar changes for this view controller. This currently only affects changes to prefersStatusBarHidden.
  • 手动灵活改变UIStatusBar
    可以调用下面方法:
// This should be called whenever the return values for the view controller's status bar attributes have changed. If it is called from within an animation block, the changes will be animated along with the rest of the animation block.
- (void)setNeedsStatusBarAppearanceUpdate NS_AVAILABLE_IOS(7_0) __TVOS_PROHIBITED;

先设置好显示不同样式条件返回:

- (UIStatusBarStyle)preferredStatusBarStyle{
    if (self.customNavigationBar.separateLine.hidden) {
        return UIStatusBarStyleLightContent;
    } else {
        return UIStatusBarStyleDefault;
    }
}

然后在需要的时候调用:

[self setNeedsStatusBarAppearanceUpdate];

重点东西就这么多.
解决问题期间搜索到错误的答案,也给提个醒. 具体那个错误答案,戳我
如下图:

错误答案

按照上面实现分类后, present 出来的UIViewControllerUIStatusBar正常.
- (void)dismissViewControllerAnimated: (BOOL)flag completion: (void (^ __nullable)(void))completion NS_AVAILABLE_IOS(5_0);后就变不回来了.

@property(nullable, nonatomic,readonly,strong) UIViewController *visibleViewController; // Return modal view controller if it exists. Otherwise the top view controller.

原因是dismissViewControllerAnimated调用后立马就引发系统刷新状态栏, 但是这时被dismiss的ViewController没有立马消失, 所以visibleViewController依然是这个未消失的ViewController,导致系统调用了错误的preferredStatusBarStyle.

提示一点系统默认是UIStatusBarStyleDefault, 如果App需要默认的UIStatusBarStyleLightContent.
建个分类改改就OK:

@implementation UIViewController (LMStatusBarStyle)

- (UIStatusBarStyle)preferredStatusBarStyle {
    return UIStatusBarStyleLightContent;
}
@end

OK, UIStatusBar的正确使用姿势暂时就这么多.

2017.10.14 更新一个坑

self.navigationController.navigationBarHidden = NO

如果导航栏是隐藏的,然后再显示,有可能导致显示错误.
上面代码会引发状态栏的刷新,但是self.navigationController不会自动向viewControllers传递,而是自动调用- (UIStatusBarStyle)preferredStatusBarStyle方法.

所以需要我们手动实现传递方法:

- (UIViewController *)childViewControllerForStatusBarStyle;
- (UIViewController *)childViewControllerForStatusBarHidden;

建立UINavigationController分类

@implementation UINavigationController (StatusBar)

- (UIViewController *)childViewControllerForStatusBarStyle{
    return self.viewControllers.lastObject;
}

- (UIViewController *)childViewControllerForStatusBarHidden{
    return self.viewControllers.lastObject;
}

@end

Demo戳我

2017.10.15 更新一个坑

self.navigationController.navigationBar.barStyle = UIBarStyleBlack;

设置barStyleUIBarStyleBlack,会导致navigationControllerpreferredStatusBarStyle 默认值 变为 UIStatusBarStyleLightContent

如果没有设置任何UIStatusBarStyleLightContent, statusBar却莫名其妙变为UIStatusBarStyleLightContent, 那极有可能barStyle被设置为UIBarStyleBlack.
( 不知道是不是UITabBarController也具备相同特性的)

demo还是上面那个,可以打开下面注释测试下:

 //改变navigationController 的 preferredStatusBarStyle 默认值 变为 UIStatusBarStyleLightContent
self.navigationController.navigationBar.barStyle = UIBarStyleBlack;
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,519评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,842评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,544评论 0 330
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,742评论 1 271
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,646评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,027评论 1 275
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,513评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,169评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,324评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,268评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,299评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,996评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,591评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,667评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,911评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,288评论 2 345
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,871评论 2 341

推荐阅读更多精彩内容