iOS：導(dǎo)航欄的隱藏和顯示

最近接入第三方 SDK 時(shí)碰到個(gè)蛋疼的 bug。

前提：

  1. 當(dāng)前項(xiàng)目在基類 VC 中使用屬性 hidesNavigationBarWhenPush 來標(biāo)識(shí)是否顯示導(dǎo)航欄；
  2. 基類 VC 中，在 willAppear 中使用[self.navigationController setNavigationBarHidden:self.hidesNavigationBarWhenPush animated:animated];來控制導(dǎo)航欄的顯示和隱藏；

Bug

  1. 某個(gè) parentVC 中包含兩個(gè) childVC，3個(gè) VC 都使用 self. hidesNavigationBarWhenPush = NO 來顯示導(dǎo)航欄：
    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. 跳轉(zhuǎn)到第三方 SDK 的 VC 之后，pop 回 mainVC，導(dǎo)航欄就不顯示了；

  2. 第三方 SDK 的容器 VC 繼承自第三方 SDK 的基類VC：


    VC

解決

Bug 的解決倒是很簡(jiǎn)單，在第三方SDK的容器VC中添加：

- (void)viewWillDisappear:(BOOL)animated {
    [super viewWillDisappear:animated];
    // 內(nèi)部sdk直接把navigationBar隱藏了，要在pop之后顯示
    self.navigationController.navigationBar.hidden = NO;
}

原因

其實(shí)原因也很簡(jiǎn)單，就是第三方 SDK 未采用 apple 推薦的方法來控制導(dǎo)航欄的顯示和隱藏：

@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 的顯示和隱藏，兩種方式的區(qū)別在于一個(gè)能控制動(dòng)畫，一個(gè)是無動(dòng)畫效果的；

Apple 的這種邏輯其實(shí)也能理解，因?yàn)閷?dǎo)航欄的顯示不僅僅是 navigationBar.hidden 就能決定的，比如 title 的設(shè)定、willAppear 方法中的控制、父子控制器中導(dǎo)航欄的邏輯等。雖然最終 Apple 也是通過所以 navigationBar.hidden = YES/NO 來設(shè)置的，但是 Apple 屏蔽了 Nav、TabVC、ChildVC 等許多邏輯，如果直接調(diào)用 navigationBar.hidden = YES/NO ，則會(huì)破壞內(nèi)部的邏輯順序，導(dǎo)致系統(tǒng)的導(dǎo)航欄隱藏/顯示邏輯失效，出現(xiàn)一些奇怪的 Bug；

而三方 SDK 內(nèi)部是通過 self.navigationController.navigationBar.hidden = YES 來暴力強(qiáng)制地直接隱藏了導(dǎo)航欄。

三方 SDK 這么做也有其道理，因?yàn)?SDK 會(huì)被很多公司的項(xiàng)目引用，難免會(huì)遇到一些不同的場(chǎng)景，某些場(chǎng)景下，如果甲方項(xiàng)目也沒有按照 Apple 的正規(guī)流程來設(shè)置導(dǎo)航欄的隱藏和顯示，那么就會(huì)吃屎。估計(jì)是這么做也是為了強(qiáng)制隱藏導(dǎo)航欄。

總結(jié)：

  1. 三方SDK通過navigationBar.hidden = YES; 隱藏了導(dǎo)航欄；
  2. 在三方SDK的容器VC將要消失之前，設(shè)置navigationBar.hidden = NO;即可；

疑問：
其實(shí)這里還有個(gè)疑問，雖然設(shè)置了 navigationBar.hidden = YES;，但是當(dāng)返回到 parentVC 時(shí)，willAppear 方法里面肯定是是會(huì)調(diào)用導(dǎo)航欄顯示代碼的：

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

那為什么不能正常顯示呢？

接著往下看......

還沒完呢

就 bug 而言，其意義在于規(guī)范一下 navigationBar 的使用，但是這里有一個(gè)奇怪的現(xiàn)象，從前提中可知道，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 就沒有了；

那么原因是什么呢？其實(shí)這個(gè)原因和上文的疑問本質(zhì)原因是一樣的，就是：

[self.navigationController setNavigationBarHidden:animated:];方法內(nèi)部會(huì)判斷 Hidden 是否發(fā)生了改變，如果未改變，直接 return；

偽代碼如下：

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

    if(self.hidden == hidden) return;

    // other code...
}

其實(shí) iOS12 之后就有很多這種代碼保護(hù)，比如之前碰到 App 的換膚功能，在換膚之后，View 的 backgroundColor 更新不及時(shí)。因?yàn)槲覀冺?xiàng)目中自定義了 color 對(duì)象，使用同一個(gè)對(duì)象表示不同皮膚下的色值，所以很可能導(dǎo)致了系統(tǒng)出現(xiàn)以下判斷：

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

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

}

解決辦法就一句代碼：

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

其實(shí) Apple 的這種優(yōu)化代碼也很有道理，因?yàn)檫@樣可以避免沒有必要的重繪，提高性能，再加之這種代碼調(diào)用頻率特別高，所以一句簡(jiǎn)單的相等判斷可以省下很多性能消耗；

所以，Apple 所認(rèn)為的正常的隱藏/顯示導(dǎo)航欄的邏輯就是通過對(duì)應(yīng)的兩個(gè)方法來操作，然后內(nèi)部自己會(huì)進(jìn)行一些邏輯判斷之后最終設(shè)置navigationBar.hidden 的值。

然鵝，當(dāng) SDK 的容器 VC 通過非常規(guī)手段設(shè)置了 navigationBar.hidden = YES;之后，self.navigationController. navigationBarHidden 的值并沒有發(fā)生變化，即值仍為 NO，所以當(dāng) SDK 的容器 VC 在 pop 之后，parentVC 調(diào)用到setNavigationBarHidden方法時(shí)，判斷 self.navigationController. navigationBarHidden 的值并未發(fā)生改變，最終直接 return；

而之所以去掉 parentVC 中的那段代碼(self.hidesNavigationBarWhenPush = NO;) 能夠解決這個(gè) Bug，就是因?yàn)?/p>

  1. 基類 VC 中默認(rèn) hidesNavigationBarWhenPush = YES，所以 parentVC.navigationController.navigationBarHidden = YES;
  2. SDKVC 中 self.navigationController.navigationBarHidden 為默認(rèn)值，即為 NO；
  3. 當(dāng) SDKVC 被 pop 時(shí)，parentVC 通過基類調(diào)用了 viewWillAppear 方法。因?yàn)?navigationController.navigationBarHidden 的值不一致，所以沒有直接 return，走完系統(tǒng)內(nèi)部邏輯之后，重新設(shè)置了 navigationBar.hidden = YES;
  4. 上一步之后，其實(shí)仍然應(yīng)該不顯示導(dǎo)航欄，但就是因?yàn)?parentVC 是通過 childVC 的形式組織 VC，所以此時(shí) childVC 的 willAppear 方法被調(diào)用；
  5. childVC 中的 self.navigationController.navigationBarHidden = NO，這個(gè)值又發(fā)生了改變，所以沒有直接 return，最終設(shè)置為 navigationBar.hidden = NO; 顯示了導(dǎo)航欄；

這個(gè)過程還真的是一波三折啊，很蛋疼啊......腦殼痛????......希望我解釋清楚了......

進(jìn)而，還有一種解決辦法，在SDK的容器VC中：

- (void)viewWillAppear:(BOOL)animated {
    // 調(diào)用super，內(nèi)部直接設(shè)置了navigationBar.hidden = YES; 
    [super viewWillAppear:animated];
    
    /**
     * apple明確指出只能使用self.navigationController.navigationBarHidden或者setNavigationBarHidden:animated:來設(shè)置導(dǎo)航欄隱藏/顯示；
     * 三方SDK內(nèi)部直接設(shè)置的self.navigationController.navigationBar.hidden = YES未按照apple的正規(guī)流程來設(shè)置，這就導(dǎo)致pop之后，雖然導(dǎo)航欄隱藏/顯示狀態(tài)發(fā)生了變化，但self.navigationController.navigationBarHidden的值未發(fā)生變化；
     * 系統(tǒng)內(nèi)部應(yīng)該是會(huì)對(duì)比self.navigationController.navigationBarHidden 值是否一致，如果不一致才去設(shè)置 navigationBar.hidden = self.navigationController.navigationBarHiddenl；這樣可以避免頻繁設(shè)置hidden引起的性能問題；
     * 直接在disappear方法中設(shè)置navigationBar.hidden = NO可能存在潛在風(fēng)險(xiǎn)；
     * 所以，解決這個(gè)Bug的最好方式應(yīng)該是讓流程正規(guī)化；
    */
    [self.navigationController setNavigationBarHidden:YES animated:YES];

    // toher code...
    xxxxx
}

總結(jié)

關(guān)鍵點(diǎn)：

  1. [self.navigationController setNavigationBarHidden:animated:]; 方法中會(huì)對(duì) navigationBarHidden的值進(jìn)行對(duì)比，如果一樣，就直接return，如果不一樣，就設(shè)置 self.navigationBar.hidden = self.navigationController. navigationBarHidden;
  2. parentVC 的 willAppear、viewDidAppear 調(diào)用順序先于 childVC，如果是在 VC 中設(shè)置導(dǎo)航欄顯示/隱藏，就會(huì)出現(xiàn) childVC 主導(dǎo)導(dǎo)航欄的效果；

最關(guān)鍵的：
self.navigationController.navigationBarHidden 是唯一的、正規(guī)的渠道來控制導(dǎo)航欄的隱藏和顯示；

有了這個(gè)意識(shí)，在 viewDidLoad，還是 willAppear 等方法中來設(shè)置這個(gè)值，就看不同 App 自己的業(yè)務(wù)邏輯了。

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容