如何获取 iPhone 刘海或 Dynamic Island 的实际尺寸用于 SwiftUI 横屏布局?
能否通过 safeAreaInsets 获取实际尺寸?
safeAreaInsets 提供的是视图的安全区域边距,不能用来还原刘海高度或 Dynamic Island 的遮挡轮廓。在核对的 Apple 公开文档中,没有找到覆盖各 iPhone 型号的完整遮挡尺寸表,也没有找到供普通应用查询精确刘海或 Dynamic Island 外框的公开 API。
如果要避免内容被遮挡,可以使用安全区域。如果要求内容距离刘海实际边缘恰好 15 points,仅靠安全区域就不足以计算。
为什么安全区域大于刘海的实际尺寸?
安全区域用于安排可见、可操作的内容,还要考虑系统栏和设备显示特征,并不是沿刘海边缘逐点描绘出的形状。Apple 的布局指南建议使用安全区域避开 Dynamic Island 等特征,并通过设计资源提供布局参考。Apple 布局指南
因此,观察到 47 points 的边距,不能推断刘海深度就是 47 points,也无法仅凭这个数值确定多出来的部分是否全部来自屏幕圆角。
safeAreaInsets 的值还与所在视图有关。UIKit 文档说明,已经完全位于父视图安全区域内的子视图,其安全区域边距可以为 0。它不适合作为机型的固定硬件参数。UIView.safeAreaInsets
原代码中的宽度计算有哪些问题?
原代码将 GeometryReader 的布局尺寸与安全区域边距相加,试图还原屏幕宽度:
let totalWidth = geometry.size.width
+ geometry.safeAreaInsets.leading
+ geometry.safeAreaInsets.trailing
这个等式只有在特定布局前提下才能成立。geometry.size.width 是当前容器获得的宽度;在导航容器、嵌套视图或忽略安全区域的布局中,它不一定等于屏幕宽度减去左右安全边距。
后面的计算可以直接化简为:
let width = geometry.size.width
+ geometry.safeAreaInsets.leading
- 30
其中 trailing 被抵消,安全区域边距中只剩下 leading。这段代码没有表示刘海位于哪一侧,以及它向内延伸了多少。
此外,leading 和 trailing 表示阅读方向上的起点和终点,不能始终当作物理左侧和右侧。
如何先实现可靠的横屏布局?
可以先让内容遵守系统安全区域,再在内部增加左右各 15 points 的间距。下面的示例保留显式宽度,适用于外层容器正常遵守安全区域、没有额外水平 padding 的情况:
import SwiftUI
struct ContentView: View {
private let horizontalPadding: CGFloat = 15
var body: some View {
GeometryReader { geometry in
VStack {
Spacer()
Rectangle()
.fill(Color.red)
.frame(
width: max(
0,
geometry.size.width - 2 * horizontalPadding
),
height: 30
)
Spacer()
}
.frame(
width: geometry.size.width,
height: geometry.size.height
)
}
}
}
这里不需要按机型硬编码尺寸,也不需要自行区分刘海所在的一侧。应在左右横屏方向分别检查布局。
这个方案让内容距离安全区域左右边界各 15 points,并不保证距离刘海实际边缘和另一侧屏幕边缘各 15 points。两者在视觉上仍可能不同。
必须紧贴刘海边缘时,尺寸资料怎么用?
如果精确间距是设计的必要条件,就需要额外取得并验证遮挡几何数据。可以先查看 Apple Design Resources 中目标机型的模板,确认资源是否包含所需边界。安全区域模板只能说明建议布局范围,不能直接当作硬件尺寸表。
问题中引用的资料针对 iPhone X,不能据此认定其他机型也使用 30 points。对于 Dynamic Island,还需要区分物理开孔与系统绘制的可见区域;测量前应确定要避开哪一种边界。
假设内容所在横条确实与遮挡区域相交,且使用同一坐标空间中的数据:
W:当前全屏容器宽度。L、R:该横条位置需要从物理左、右边缘避让的距离。p:额外间距,例如 15 points。
则可以按以下公式布局:
x = L + p
width = max(0, W - L - R - 2 * p)
难点是取得可靠的 L 和 R,不能直接用 safeAreaInsets 替代。刘海有曲线轮廓,横条的垂直位置和高度也会影响它是否与刘海相交。
如果维护自己的尺寸表,应记录测量使用的机型、显示设置、方向和单位,避免混用 pixels 与 points;遇到未知机型时回退到系统安全区域。这样既能保留已验证机型的精细布局,也能为后续设备提供可用的默认行为。
备注:内容仅供参考。
