Disable scrolling in SwiftUI ScrollView and List

In iOS 16, SwiftUI finally got a new modifier, scrollDisabled(_:), to disable scrolling in ScrolView and List.

Actually, you can use this modifier to disable scrolling for any scrollable views, such as TextEditor.

How to disable scrolling in ScrollView and List

To disable a scrolling, you put .scrollDisabled(true) to the scrollable view, such as List and ScrollView.

Disable scrolling in ScrollView.

ScrollView {
    VStack {
        ForEach(0..<7) { i in
            Text("Row \(i.description)")
        }
    }
}
.scrollDisabled(true)

Disable scrolling in List.

List(0..<7) { i in
    Text("Row \(i.description)")
}
.scrollDisabled(true)

You can easily support sarunw.com by checking out this sponsor.

AI Grammar: Correct grammar, spell check, check punctuation, and parphrase.

Try it for Free

scrollDisabled affects all scrollable views

The .scrollDisabled modifier affects all scrollable views within a view hierarchy.

In the following example, both the ScrollView(.horizontal) and List views are disabled.

List {
    ScrollView(.horizontal) {
        HStack {
            ForEach(0..<7) { i in
                Text("Column \(i.description)")
            }
        }
    }
    ForEach(0..<7) { i in
        Text("Row \(i.description)")
    }
}
.scrollDisabled(true)

The bad news is we have no way to enable scrolling of the inner scroll view if the .scrollDisabled is set to true on the parent view.

Setting .scrollDisabled(false) on the inner ScrollView won't work.

List {
    ScrollView(.horizontal) {
        HStack {
            ForEach(0..<7) { i in
                Text("Column \(i.description)")
            }
        }
    }
    .scrollDisabled(false)
    ForEach(0..<7) { i in
        Text("Row \(i.description)")
    }
}
.scrollDisabled(true)

You can easily support sarunw.com by checking out this sponsor.

AI Grammar: Correct grammar, spell check, check punctuation, and parphrase.

Try it for Free

Environment Value

SwiftUI passes the disabled state through the environment value, isScrollEnabled.

If you want an inner view to react to this value, you can read it like this.

@Environment(\.isScrollEnabled) private var isScrollEnabled