SwiftUI 滚动控制：内容不足时自动禁用 ScrollView

ScrollView 默认总是允许用户拖动回弹（Bounce），即使内容高度小于屏幕高度。这在某些 UI 设计中会显得不够精致。本文介绍三种不同层级的解决方案，从原生 API 到布局技巧。

方案 1：原生完美方案 (iOS 16.4+)

这是目前最推荐的标准做法。通过 scrollBounceBehavior 修饰符，系统会自动检测内容尺寸与容器尺寸的关系。

• 适用场景：绝大多数标准列表和滚动视图。
• 优势：一行代码，系统级支持，性能最优。

struct BasedOnSizeView: View {
    var body: some View {
        ScrollView {
            VStack {
                ForEach(0..<5) { idx in
                    Text("Item \(idx)")
                        .frame(maxWidth: .infinity)
                        .padding()
                }
            }
        }
        // 关键代码：仅当内容超出容器时才允许滚动回弹
        .scrollBounceBehavior(.basedOnSize, axes: .vertical)
    }
}

方案 2：布局切换方案 (ViewThatFits)

如果你希望在内容不足时完全改变视图结构（例如：内容少时用 VStack 居中显示，内容多时用 ScrollView 滚动），ViewThatFits 是最佳选择。

• 适用场景：需要在滚动与非滚动状态下展示完全不同布局的场景。
• 原理：它会依次尝试闭包中的视图，选择第一个能“装得下”的视图。

struct AdaptiveScrollView: View {
    let contentString: String
    
    var body: some View {
        // 优先尝试直接展示内容（无滚动）
        // 如果高度溢出，则回退到 ScrollView
        ViewThatFits(in: .vertical) {
            textContent
            
            ScrollView {
                textContent
            }
        }
        .frame(height: 200)
        .border(.gray)
    }
    
    var textContent: some View {
        Text(contentString)
            .padding()
            .fixedSize(horizontal: false, vertical: true) // 确保文本垂直方向撑开
    }
}

方案 3：底层控制 (Introspect)

在极少数需要通过 UIScrollView 属性进行精细控制（如完全禁用手势交互 isScrollEnabled = false 而不仅仅是禁用回弹）的场景下，可以使用 Introspect 库。

注意：在 Swift 6 / iOS 26 时代，通常前两种原生方案已能覆盖 99% 的需求，建议仅作为最后的备选手段。

import SwiftUIIntrospect

ScrollView {
    // Content...
}
.introspect(.scrollView, on: .iOS(.v16, .v17, .v18, .v26)) { scrollView in
    // 手动判断逻辑
    if scrollView.contentSize.height <= scrollView.bounds.height {
        scrollView.isScrollEnabled = false
    } else {
        scrollView.isScrollEnabled = true
    }
}

总结

方案	API 要求	复杂度	推荐指数
scrollBounceBehavior	iOS 16.4+	⭐	⭐⭐⭐⭐⭐
ViewThatFits	iOS 16.0+	⭐⭐	⭐⭐⭐⭐
Introspect	第三方库	⭐⭐⭐	⭐⭐

延伸阅读

• 掌握 ViewThatFits
• ScrollView 的新功能