<!--
{
  "availability" : [
    "iOS: 16.0.0 -",
    "iPadOS: 16.0.0 -",
    "macCatalyst: 16.0.0 -",
    "macOS: 13.0.0 -",
    "tvOS: 16.0.0 -",
    "watchOS: 9.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/View/scrollDismissesKeyboard(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI4ViewPAAE23scrollDismissesKeyboardyQrAA06ScrolleF4ModeVF"
  },
  "title" : "scrollDismissesKeyboard(_:)"
}
-->

# scrollDismissesKeyboard(_:)

Configures the behavior in which scrollable content interacts with
the software keyboard.

```
nonisolated func scrollDismissesKeyboard(_ mode: ScrollDismissesKeyboardMode) -> some View
```

## Parameters

`mode`

The keyboard dismissal mode that scrollable content
uses.

## Return Value

A view that uses the specified keyboard dismissal mode.

## Discussion

You use this modifier to customize how scrollable content interacts
with the software keyboard. For example, you can specify a value of
[`immediately`](/documentation/SwiftUI/ScrollDismissesKeyboardMode/immediately) to indicate that you
would like scrollable content to immediately dismiss the keyboard if
present when a scroll drag gesture begins.

```
@State private var text = ""

ScrollView {
    TextField("Prompt", text: $text)
    ForEach(0 ..< 50) { index in
        Text("\(index)")
            .padding()
    }
}
.scrollDismissesKeyboard(.immediately)
```

You can also use this modifier to customize the keyboard dismissal
behavior for other kinds of scrollable views, like a [`List`](/documentation/SwiftUI/List) or a
[`TextEditor`](/documentation/SwiftUI/TextEditor).

By default, a [`TextEditor`](/documentation/SwiftUI/TextEditor) is interactive while other kinds
of scrollable content always dismiss the keyboard on a scroll
when linked against iOS 16 or later. Pass a value of
[`never`](/documentation/SwiftUI/ScrollDismissesKeyboardMode/never) to indicate that scrollable
content should never automatically dismiss the keyboard.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)