《iOS 11 安全區域適配總結》

騰訊bugly發表於2017-12-04

本文來自於騰訊Bugly公眾號(weixinBugly),作者:sonialiu,未經作者同意,請勿轉載,原文地址:http://mp.weixin.qq.com/s/W1_0VrchCO50owhJNmJnuQ

| 導語 本文主要是對iOS 11下企鵝 FM APP中tableView內容下移20pt或下移64pt的問題適配的一個總結。內容包括五個部分:問題的原因分析、adjustContentInset屬性的計算方式、什麼情況下的tableView會發生內容下移、有哪些解決方法、解決這個問題時遇到的另外一個小問題。

一、iOS 11下APP中tableView內容下移20pt或下移64pt的原因分析

問題如下圖所示:
http://img.blog.csdn.net/20170926095658997?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvVGVuY2VudF9CdWdseQ==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast

1. 原因分析

原因是iOS 11中Controller的automaticallyAdjustsScrollViewInsets屬性被廢棄了,所以當tableView超出安全區域時系統自動調整了SafeAreaInsets值,進而影響adjustedContentInset值,在iOS 11中決定tableView的內容與邊緣距離的是adjustedContentInset屬性,而不是contentInset。adjustedContentInset的計算方式見本文第二部分內容。因為系統對adjustedContentInset值進行了調整,所以導致tableView的內容到邊緣的距離發生了變化,導致tableView下移了20pt(statusbar高度)或64pt(navigationbar高度)。

如果你的APP中使用的是自定義的navigationbar,隱藏掉系統的navigationbar,並且tableView的frame為(0,0,SCREENWIDTH, SCREENHEIGHT)開始,那麼系統會自動調整SafeAreaInsets值為(20,0,0,0),如果使用了系統的navigationbar,那麼SafeAreaInsets值為(64,0,0,0),如果也使用了系統的tabbar,那麼SafeAreaInsets值為(64,0,49,0)。關於什麼情況下會發生內容下移的問題,本文第三部分有介紹。

2. 安全區域的概念

系統自動調整tableView內容偏移量,是根據安全區域來調整的。安全區域是iOS 11新提出的,如下圖所示:
http://img.blog.csdn.net/20170926100519768?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvVGVuY2VudF9CdWdseQ==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast

安全區域幫助我們將view放置在整個螢幕的可視的部分。即使把navigationbar設定為透明的,系統也認為安全區域是從navigationbar的bottom開始,保證不被系統的狀態列、或導航欄覆蓋。可以使用additionalSafeAreaInsets去擴充套件安全區域使它包括自定義的content在介面上。每個view都可以改變安全區域嵌入的大小,Controller也可以。

safeAreaInsets屬性反映了一個view距離該view的安全區域的邊距。對於一個Controller的根檢視而言,SafeAreaInsets值包括了被statusbar和其他可視的bars覆蓋的區域和其他通過additionalSafeAreaInsets自定義的insets值。view層次中的其它view,SafeAreaInsets值反映了該view被覆蓋的部分。如果一個view全部在它父檢視的安全區域內,則SafeAreaInsets值為(0,0,0,0)。

二、 adjustContentInset屬性的計算方式

首先看scrollView在iOS11新增的兩個屬性:adjustContentInset 和 contentInsetAdjustmentBehavior。

/* Configure the behavior of adjustedContentInset.

Default is UIScrollViewContentInsetAdjustmentAutomatic.
*/@property(nonatomic) UIScrollViewContentInsetAdjustmentBehavior contentInsetAdjustmentBehavior
adjustContentInset表示contentView.frame.origin偏移了scrollview.frame.origin多少;是系統計算得來的,計算方式由contentInsetAdjustmentBehavior決定。有以下幾種計算方式:

1.UIScrollViewContentInsetAdjustmentAutomatic:如果scrollview在一個automaticallyAdjustsScrollViewContentInset = YES的controller上,並且這個Controller包含在一個navigation controller中,這種情況下會設定在top & bottom上 adjustedContentInset = safeAreaInset + contentInset不管是否滾動。其他情況下與UIScrollViewContentInsetAdjustmentScrollableAxes相同

2.UIScrollViewContentInsetAdjustmentScrollableAxes: 在可滾動方向上adjustedContentInset = safeAreaInset + contentInset,在不可滾動方向上adjustedContentInset = contentInset;依賴於scrollEnabled和alwaysBounceHorizontal / vertical = YES,scrollEnabled預設為yes,所以大多數情況下,計算方式還是adjustedContentInset = safeAreaInset + contentInset

3.UIScrollViewContentInsetAdjustmentNever: adjustedContentInset = contentInset

4.UIScrollViewContentInsetAdjustmentAlways: adjustedContentInset = safeAreaInset + contentInset

當contentInsetAdjustmentBehavior設定為UIScrollViewContentInsetAdjustmentNever的時候,adjustContentInset值不受SafeAreaInset值的影響。

三、什麼情況下的tableView會發生上述問題

如果設定了automaticallyAdjustsScrollViewInsets = YES,那麼不會發生問題,一直都是由系統來調整內容的偏移量。

接下來排查下自己的專案中哪些頁面會發生以上問題。

當tableView的frame超出安全區域範圍時,系統會自動調整內容的位置,SafeAreaInsets值會不為0,於是影響tableView的adjustContentInset值,於是影響tableView的內容展示,導致tableView的content下移了SafeAreaInsets的距離。SafeAreaInsets值為0時,是正常的情況。

需要了解每個頁面的結構,看tableView是否被系統的statusbar或navigationbar覆蓋,如果被覆蓋的話,則會發生下移。也可以通過tableview.safeAreaInsets的值來確認是因為安全區域的問題導致的內容下移。

如下程式碼片段,可以看出系統對tableView向下調整了20pt的距離,因為tableView超出了安全區域範圍,被statusbar覆蓋。

tableview.contentInset: {64, 0, 60, 0}

tableview.safeAreaInsets: {20, 0, 0, 0}

tableview.adjustedContentInset: {84, 0, 60, 0}

四、這個問題的解決方法有哪些?

1. 重新設定tableView的contentInset值,來抵消掉SafeAreaInset值,因為內容偏移量 = contentInset + SafeAreaInset;

如果之前自己設定了contentInset值為(64,0,0,0),現在系統又設定了SafeAreaInsets值為(64,0,0,0),那麼tableView內容下移了64pt,這種情況下,可以設定contentInset值為(0,0,0,0),也就是遵從系統的設定了。

2. 設定tableView的contentInsetAdjustmentBehavior屬性

如果不需要系統為你設定邊緣距離,可以做以下設定:

 //如果iOS的系統是11.0,會有這樣一個巨集定義“#define __IPHONE_11_0  110000”;如果系統版本低於11.0則沒有這個巨集定義#ifdef __IPHONE_11_0   
if ([tableView respondsToSelector:@selector(setContentInsetAdjustmentBehavior:)]) {
    tableView.contentInsetAdjustmentBehavior = UIScrollViewContentInsetAdjustmentNever;
}
#endif

contentInsetAdjustmentBehavior屬性也是用來取代automaticallyAdjustsScrollViewInsets屬性的,推薦使用這種方式。

3. 通過設定iOS 11新增的屬性addtionalSafeAreaInset;

iOS 11之前,大家是通過將Controller的automaticallyAdjustsScrollViewInsets屬性設定為NO,來禁止系統對tableView調整contentInsets的。如果還是想從Controller級別解決問題,那麼可以通過設定Controller的additionalSafeAreaInsets屬性,如果SafeAreaInset值為(20,0,0,0),那麼設定additionalSafeAreaInsets屬性值為(-20,0,0,0),則SafeAreaInsets不會對adjustedContentInset值產生影響,tableView內容不會顯示異常。這裡需要注意的是addtionalSafeAreaInset是Controller的屬性,要知道SafeAreaInset的值是由哪個Controller引起的,可能是由自己的Controller調整的,可能是navigationController調整的。是由哪個Controller調整的,則設定哪個Controller的addtionalSafeAreaInset值來抵消掉SafeAreaInset值。

五、遇到的另外一個與安全區域無關的tableView內容下移的問題

我的作品頁面的tableView下移了約40pt,這裡是否跟安全區域有關呢?
http://img.blog.csdn.net/20170926100650727?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvVGVuY2VudF9CdWdseQ==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast

查了下頁面結構,tableView的父檢視的frame在navigationbar的bottom之下,tableView在父檢視的安全區域內,列印出來tableView的SafeAreaInset值也是(0,0,0,0);所以不是安全區域導致的內容下移。

經過檢視程式碼,發現tableView的style:UITableViewStyleGrouped型別,預設tableView開頭和結尾是有間距的,不需要這個間距的話,可以通過實現heightForHeaderInSection方法(返回一個較小值:0.1)和viewForHeaderInSection(返回一個view)來去除頭部的留白,底部同理。

iOS 11上發生tableView頂部有留白,原因是程式碼中只實現了heightForHeaderInSection方法,而沒有實現viewForHeaderInSection方法。那樣寫是不規範的,只實現高度,而沒有實現view,但程式碼這樣寫在iOS 11之前是沒有問題的,iOS 11之後應該是由於開啟了估算行高機制引起了bug。新增上viewForHeaderInSection方法後,問題就解決了。或者新增以下程式碼關閉估算行高,問題也得到解決。

self.tableView.estimatedRowHeight = 0;

self.tableView.estimatedSectionHeaderHeight = 0;

self.tableView.estimatedSectionFooterHeight = 0;

相關文章