如何开启iOS系统中点击notch（刘海）返回页面顶部的功能

iOS 系统自带的点击状态栏区域返回滚动视图顶部功能无需额外开发原生代码，失效可按以下优先级排查：

• 排查多滚动容器冲突：系统默认仅会给最上层 scrollsToTop = true 的 UIScrollView 及其子类（UITableView、WKWebView 滚动容器等）派发回顶事件，若同一页面存在多个开启该属性的滚动容器，系统无法判定响应对象会直接丢弃事件。解决方法是将不需要响应回顶的滚动容器的 scrollsToTop 属性设为 false，仅保留目标滚动容器开启该属性。
• 排查顶层视图拦截：若你在状态栏/ notch 区域叠加了自定义 UIView 且开启了 userInteractionEnabled = true，点击事件会被自定义视图拦截无法透传给系统。可将自定义视图的用户交互属性关闭，或重写自定义视图的点击事件手动触发滚动容器回顶逻辑。
• 排查状态栏隐藏配置：如果全局调用 setStatusBarHidden: 方法隐藏了状态栏，即使 notch 区域可见系统也不会触发回顶功能，需保持状态栏处于显示状态。
• 排查 WebView 场景的 H5 逻辑：若用 WKWebView 承载业务页面，检查 H5 代码是否全局监听了 touch 类事件并调用 preventDefault()，该操作会阻断系统对状态栏点击事件的识别，需调整事件拦截逻辑仅作用于需要的业务元素。

跨端框架额外排查项 #

• Flutter 项目：确认 Scaffold 的 primary 属性设置正确，且同一页面仅存在一个 ScrollView 类组件（ListView、SingleChildScrollView 等）设置 primary: true。
• React Native 项目：检查 ScrollView 组件的 scrollsToTop 属性是否开启，且同一时间仅一个可滚动组件开启该属性。

内容的提问来源于stack exchange，提问作者Ahmad Majd