iOS:导航栏的隐藏和显示

最近接入第三方 SDK 时碰到个蛋疼的 bug。

前提:

  1. 当前项目在基类 VC 中使用属性 hidesNavigationBarWhenPush 来标识是否显示导航栏;
  2. 基类 VC 中,在 willAppear 中使用[self.navigationController setNavigationBarHidden:self.hidesNavigationBarWhenPush animated:animated];来控制导航栏的显示和隐藏;

Bug

  1. 某个 parentVC 中包含两个 childVC,3个 VC 都使用 self. hidesNavigationBarWhenPush = NO 来显示导航栏:
    parentVC

parentVC 代码如下:

- (void)viewDidLoad {
    [super viewDidLoad];
    self.hidesNavigationBarWhenPush = NO;
    self.navigationItem.rightBarButtonItem = self.rigthBarBtnItem;
    
    self.navigationItem.titleView = self.titleView;
    [self.titleView setSelectedItemIndex:self.selectedIndex subItemIndex:0];
}
  1. 跳转到第三方 SDK 的 VC 之后,pop 回 mainVC,导航栏就不显示了;
  2. 第三方 SDK 的容器 VC 继承自第三方 SDK 的基类VC:


    VC

解决

Bug 的解决倒是很简单,在第三方SDK的容器VC中添加:

- (void)viewWillDisappear:(BOOL)animated {
    [super viewWillDisappear:animated];
    // 内部sdk直接把navigationBar隐藏了,要在pop之后显示
    self.navigationController.navigationBar.hidden = NO;
}

原因

其实原因也很简单,就是第三方 SDK 未采用 apple 推荐的方法来控制导航栏的显示和隐藏:

@property(nonatomic,getter=isNavigationBarHidden) BOOL navigationBarHidden;
- (void)setNavigationBarHidden:(BOOL)hidden animated:(BOOL)animated; // Hide or show the navigation bar. If animated, it will transition vertically using UINavigationControllerHideShowBarDuration.
navigationBar属性说明

从上面的说明中可以看出,Apple 很清楚地说明了只能通过 navigationBarHidden 或者 setNavigationBarHidden:animated: 来控制 navigationBar 的显示和隐藏,两种方式的区别在于一个能控制动画,一个是无动画效果的;

Apple 的这种逻辑其实也能理解,因为导航栏的显示不仅仅是 navigationBar.hidden 就能决定的,比如 title 的设定、willAppear 方法中的控制、父子控制器中导航栏的逻辑等。虽然最终 Apple 也是通过所以 navigationBar.hidden = YES/NO 来设置的,但是 Apple 屏蔽了 Nav、TabVC、ChildVC 等许多逻辑,如果直接调用 navigationBar.hidden = YES/NO ,则会破坏内部的逻辑顺序,导致系统的导航栏隐藏/显示逻辑失效,出现一些奇怪的 Bug;

而三方 SDK 内部是通过 self.navigationController.navigationBar.hidden = YES 来暴力强制地直接隐藏了导航栏。

三方 SDK 这么做也有其道理,因为 SDK 会被很多公司的项目引用,难免会遇到一些不同的场景,某些场景下,如果甲方项目也没有按照 Apple 的正规流程来设置导航栏的隐藏和显示,那么就会吃屎。估计是这么做也是为了强制隐藏导航栏。

总结:

  1. 三方SDK通过navigationBar.hidden = YES; 隐藏了导航栏;
  2. 在三方SDK的容器VC将要消失之前,设置navigationBar.hidden = NO;即可;

疑问:
其实这里还有个疑问,虽然设置了 navigationBar.hidden = YES;,但是当返回到 parentVC 时,willAppear 方法里面肯定是是会调用导航栏显示代码的:

// self.hidesNavigationBarWhenPush = NO;
[self.navigationController setNavigationBarHidden:self.hidesNavigationBarWhenPush animated:animated];

那为什么不能正常显示呢?

接着往下看......

还没完呢

就 bug 而言,其意义在于规范一下 navigationBar 的使用,但是这里有一个奇怪的现象,从前提中可知道,mainVC 中采用 childVC 的方式来组织视图,而如果 mainVC 中去掉以下代码:

- (void)viewDidLoad {
    [super viewDidLoad];

    //    self.hidesNavigationBarWhenPush = NO;
    self.navigationItem.rightBarButtonItem = self.rigthBarBtnItem;
    
    self.navigationItem.titleView = self.titleView;
    [self.titleView setSelectedItemIndex:self.selectedIndex subItemIndex:0];
}

这样修改后,不需要额外代码,Bug 就没有了;

那么原因是什么呢?其实这个原因和上文的疑问本质原因是一样的,就是:

[self.navigationController setNavigationBarHidden:animated:];方法内部会判断 Hidden 是否发生了改变,如果未改变,直接 return;

伪代码如下:

- (void)setNavigationBarHidden:(BOOL)hidden animated:(BOOL)animated {

    if(self.hidden == hidden) return;

    // other code...
}

其实 iOS12 之后就有很多这种代码保护,比如之前碰到 App 的换肤功能,在换肤之后,View 的 backgroundColor 更新不及时。因为我们项目中自定义了 color 对象,使用同一个对象表示不同皮肤下的色值,所以很可能导致了系统出现以下判断:

- (void)setBackgroundColor:(UIColor *)backgroundColor {

    if(backgroundColor == self.backgroundColor) return;
    
    // other code...

}

解决办法就一句代码:

view.backgroundColor = nil;
view.backgroundColor = newColor;

其实 Apple 的这种优化代码也很有道理,因为这样可以避免没有必要的重绘,提高性能,再加之这种代码调用频率特别高,所以一句简单的相等判断可以省下很多性能消耗;

所以,Apple 所认为的正常的隐藏/显示导航栏的逻辑就是通过对应的两个方法来操作,然后内部自己会进行一些逻辑判断之后最终设置navigationBar.hidden 的值。

然鹅,当 SDK 的容器 VC 通过非常规手段设置了 navigationBar.hidden = YES;之后,self.navigationController. navigationBarHidden 的值并没有发生变化,即值仍为 NO,所以当 SDK 的容器 VC 在 pop 之后,parentVC 调用到setNavigationBarHidden方法时,判断 self.navigationController. navigationBarHidden 的值并未发生改变,最终直接 return;

而之所以去掉 parentVC 中的那段代码(self.hidesNavigationBarWhenPush = NO;) 能够解决这个 Bug,就是因为

  1. 基类 VC 中默认 hidesNavigationBarWhenPush = YES,所以 parentVC.navigationController.navigationBarHidden = YES;
  2. SDKVC 中 self.navigationController.navigationBarHidden 为默认值,即为 NO;
  3. 当 SDKVC 被 pop 时,parentVC 通过基类调用了 viewWillAppear 方法。因为 navigationController.navigationBarHidden 的值不一致,所以没有直接 return,走完系统内部逻辑之后,重新设置了 navigationBar.hidden = YES;
  4. 上一步之后,其实仍然应该不显示导航栏,但就是因为 parentVC 是通过 childVC 的形式组织 VC,所以此时 childVC 的 willAppear 方法被调用;
  5. childVC 中的 self.navigationController.navigationBarHidden = NO,这个值又发生了改变,所以没有直接 return,最终设置为 navigationBar.hidden = NO; 显示了导航栏;

这个过程还真的是一波三折啊,很蛋疼啊......脑壳痛😨😨......希望我解释清楚了......

进而,还有一种解决办法,在SDK的容器VC中:

- (void)viewWillAppear:(BOOL)animated {
    // 调用super,内部直接设置了navigationBar.hidden = YES; 
    [super viewWillAppear:animated];
    
    /**
     * apple明确指出只能使用self.navigationController.navigationBarHidden或者setNavigationBarHidden:animated:来设置导航栏隐藏/显示;
     * 三方SDK内部直接设置的self.navigationController.navigationBar.hidden = YES未按照apple的正规流程来设置,这就导致pop之后,虽然导航栏隐藏/显示状态发生了变化,但self.navigationController.navigationBarHidden的值未发生变化;
     * 系统内部应该是会对比self.navigationController.navigationBarHidden 值是否一致,如果不一致才去设置 navigationBar.hidden = self.navigationController.navigationBarHiddenl;这样可以避免频繁设置hidden引起的性能问题;
     * 直接在disappear方法中设置navigationBar.hidden = NO可能存在潜在风险;
     * 所以,解决这个Bug的最好方式应该是让流程正规化;
    */
    [self.navigationController setNavigationBarHidden:YES animated:YES];

    // toher code...
    xxxxx
}

总结

关键点:

  1. [self.navigationController setNavigationBarHidden:animated:]; 方法中会对 navigationBarHidden的值进行对比,如果一样,就直接return,如果不一样,就设置 self.navigationBar.hidden = self.navigationController. navigationBarHidden;
  2. parentVC 的 willAppear、viewDidAppear 调用顺序先于 childVC,如果是在 VC 中设置导航栏显示/隐藏,就会出现 childVC 主导导航栏的效果;

最关键的:
self.navigationController.navigationBarHidden 是唯一的、正规的渠道来控制导航栏的隐藏和显示;

有了这个意识,在 viewDidLoad,还是 willAppear 等方法中来设置这个值,就看不同 App 自己的业务逻辑了。

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

推荐阅读更多精彩内容