PAYATHON 2026

如何获取 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;遇到未知机型时回退到系统安全区域。这样既能保留已验证机型的精细布局,也能为后续设备提供可用的默认行为。

备注:内容仅供参考。