iPadOS中带Detents类模态UI组件识别及实现咨询

从你描述的行为和iPadOS原生组件特性来看，这个UI组件是带Detents（停靠位置）的模态表单视图，对应UIKit中的UISheetPresentationController，SwiftUI在iOS 16+也提供了适配的API实现。你之前用Sheet未达到预期，大概率是iPad上的呈现样式配置有误。

UIKit 实现（iOS 15+/iPadOS 15+） #

UISheetPresentationController是UIKit原生支持多停靠位置模态视图的核心组件，完全适配iPadOS。

核心配置步骤： #

• 创建目标视图控制器，获取其sheetPresentationController实例
• 设置detents数组定义停靠位置（支持系统预设或自定义高度）
• 可选开启拖动条、背景交互等增强配置

// 示例代码
let targetVC = YourCustomViewController()
if let sheet = targetVC.sheetPresentationController {
    // 设置停靠位置：中等高度 + 全屏
    sheet.detents = [.medium(), .large()]
    // 显示顶部拖动抓手
    sheet.prefersGrabberVisible = true
    // 设置中等高度时背景保持可交互
    sheet.largestUndimmedDetentIdentifier = .medium
}
present(targetVC, animated: true)

SwiftUI 实现（iOS 16+/iPadOS 16+） #

SwiftUI的Sheet组件支持Detents，但iPad默认会以popover形式展示，需强制设置为pageSheet样式才能实现可拖动调整高度的效果。

核心配置步骤： #

• 使用.sheet绑定视图展示状态
• 通过.presentationDetents指定停靠位置
• 添加.presentationStyle(.pageSheet)强制iPad使用页面表单样式（关键配置）
• 可选显示拖动指示器、控制背景模糊

// 示例代码
struct MainView: View {
    @State private var showSheet = false
    
    var body: some View {
        Button("打开模态视图") {
            showSheet = true
        }
        .sheet(isPresented: $showSheet) {
            SheetContent()
                // 设置停靠位置：中等高度 + 全屏
                .presentationDetents([.medium, .large])
                // 强制iPad使用页面表单样式
                .presentationStyle(.pageSheet)
                // 显示顶部拖动指示器
                .presentationDragIndicator(.visible)
                // 可选：中等高度时背景不模糊
                .presentationUndimmed(when: .medium)
        }
    }
}

struct SheetContent: View {
    var body: some View {
        Text("可拖动调整高度的模态视图")
            .padding()
            .frame(maxWidth: .infinity, maxHeight: .infinity)
            .background(Color(.systemBackground))
    }
}

Detents 相关使用要点 #

• 系统预设停靠位置：.medium()（约屏幕一半高度）、.large()（全屏）；UIKit支持.custom()自定义高度，SwiftUI在iOS 16.4+也支持自定义Detents
• iPad适配关键：SwiftUI必须设置.presentationStyle(.pageSheet)，否则会默认以popover展示，无法拖动调整高度
• 背景交互控制：UIKit用largestUndimmedDetentIdentifier，SwiftUI用.presentationUndimmed(when:)，可指定某个停靠位置下背景内容保持可交互
• 版本兼容：UIKit需部署到iOS 15+，SwiftUI完整Detents支持需iOS 16+

内容的提问来源于stack exchange，提问作者Xavier Duvan Melo