提示:
print()
可以在viewDidAppear(_:)
方法中进行测试,因为在将视图添加到视图层次结构之前,视图的safeAreaInsets
不准确。
UIView
safeAreaInsets
表示被状态、导航、标签、工具或其他栏覆盖住的不可见区域(安全区)。
var safeAreaInsets: UIEdgeInsets { get }
iPhone X 竖屏的安全区:
/** Prints view.safeAreaInsets:
*
* top: 44 + 44 (导航栏)
* left: 0
* bottom: 34 + 49 (标签栏)
* right: 0
*/
iPhone X 横屏的安全区:
/** Prints view.safeAreaInsets:
*
* top: 32 (导航栏)
* left: 44,
* bottom: 21 + 32 (标签栏)
* right: 44
*/
safeAreaLayoutGuide
表示未被状态、导航、标签、工具或其他栏覆盖住的可见区域;还要减去 additionalSafeAreaInsets
(视图控制器的属性,下文有介绍)插入的值。
var safeAreaLayoutGuide: UILayoutGuide { get }
iPhone X 横屏和竖屏的可见区域:
/** Prints view.safeAreaLayoutGuide.layoutFrame:
*
* let insets = view.safeAreaInsets
* x: insets.left
* y: insets.top
* width: view.width - insets.left - insets.right
* height: view.height - insets.top - insets.bottom
*/
safeAreaInsetsDidChange
视图的安全区域发生变化时调用:
func safeAreaInsetsDidChange() // UIView
对应的视图控制器方法是:
func viewSafeAreaInsetsDidChange() // UIViewController
UIViewController
additionalSafeAreaInsets
可以额外修改视图 safeAreaInsets
属性的值。
var additionalSafeAreaInsets: UIEdgeInsets { get set }
修改此属性时 view.safeAreaInsets
会跟着变化,例如:
additionalSafeAreaInsets.top = 40
// Prints view.safeAreaInsets.top => 44 (导航栏) + 40 = 84
UIScrollView
contentInsetAdjustmentBehavior
确定调整后的内容偏移行为。此属性指定如何使用 safe area insets 来修改滚动视图的内容区域,默认值为 .automatic
。
这篇文章已经说的很明白了:
contentInsetAdjustmentBehavior 各个值之间的区别
adjustedContentInset
合并 safeAreaInsets
(如果 contentInsetAdjustmentBehavior
可用) 和 contentInset
的值,以获取此属性的最终值。
var adjustedContentInset: UIEdgeInsets { get }
// 假设:
scrollView.safeAreaInsets.top = 44
scrollView.contentInset.top = 2
// contentInsetAdjustmentBehavior 可用:
// Prints scrollView.adjustedContentInset => 46
// contentInsetAdjustmentBehavior 不可用:
// Prints scrollView.adjustedContentInset => 2
// 如果 `contentInsetAdjustmentBehavior` 不可用则视图的 safeAreaInsets 为 0
// 总结:adjustedContentInset = safeAreaInsets + adjustedContentInset
系统还提供两个方法来监听这个属性的变化:
// UIScrollView
func adjustedContentInsetDidChange()
// UIScrollViewDelegate
func scrollViewDidChangeAdjustedContentInset(_ scrollView: UIScrollView)
UICollectionView
系统默认并没有为 UICollectionViewCell
的添加安全区,而是使用 UICollectionViewFlowLayout
的 sectionInsetReference
属性来控制它:
var sectionInsetReference: UICollectionViewFlowLayoutSectionInsetReference
public enum UICollectionViewFlowLayoutSectionInsetReference : Int {
case fromContentInset // 默认
case fromSafeArea // 使用此枚举可以把 collectionView 添加到安全区域
case fromLayoutMargins // 添加到布局边框
}
提示:
系统默认为 UITableView 使用了
insetsContentViewsToSafeArea
属性来控制是否要将其添加到安全区域,如果设置为false
,将不再保留安全间距。
参考
苹果 API
iOS 关于全面屏适配的方案及UI在不同尺寸下适配方案
最近很火的 Safe Area 到底是什么
contentInsetAdjustmentBehavior 各个值之间的区别