#188: Add support to swiping to dismiss keyboard for ScrollView

Author: Vitor Silveira

Examples/Sources/NotesExample/ContentView.swift

@@ -38,10 +38,10 @@ struct ContentView: View {
 
     var textEditorBackground: Color {
         switch colorScheme {
-        case .light:
-            Color(0.8, 0.8, 0.8)
-        case .dark:
-            Color(0.18, 0.18, 0.18)
+            case .light:
+                Color(0.8, 0.8, 0.8)
+            case .dark:
+                Color(0.18, 0.18, 0.18)
         }
     }
 

Sources/AppKitBackend/AppKitBackend.swift

@@ -861,6 +861,10 @@ public final class AppKitBackend: AppBackend {
         return scrollView
     }
 
+    public func updateScrollContainer(_ scrollView: Widget, environment: EnvironmentValues) {
+        let scrollView = scrollView as! NSScrollView
+    }
+
     public func setScrollBarPresence(
         ofScrollContainer scrollView: Widget,
         hasVerticalScrollBar: Bool,

Sources/CursesBackend/CursesBackend.swift

@@ -84,6 +84,8 @@ public final class CursesBackend: AppBackend {
 
     public func setSpacing(ofHStack container: Widget, to spacing: Int) {}
 
+    public func updateScrollContainer(_ scrollView: Widget, environment: EnvironmentValues) {}
+
     public func createTextView() -> Widget {
         let label = Label("")
         label.width = Dim.fill()

Sources/Gtk3Backend/Gtk3Backend.swift

@@ -539,6 +539,10 @@ public final class Gtk3Backend: AppBackend {
         return scrollView
     }
 
+    public func updateScrollContainer(_ scrollView: Widget, environment: EnvironmentValues) {
+        let scrollView = scrollView as! ScrolledWindow
+    }
+
     public func setScrollBarPresence(
         ofScrollContainer scrollView: Widget,
         hasVerticalScrollBar: Bool,

Sources/GtkBackend/GtkBackend.swift

@@ -503,6 +503,10 @@ public final class GtkBackend: AppBackend {
         return scrollView
     }
 
+    public func updateScrollContainer(_ scrollView: Widget, environment: EnvironmentValues) {
+        let scrollView = scrollView as! ScrolledWindow
+    }
+
     public func setScrollBarPresence(
         ofScrollContainer scrollView: Widget,
         hasVerticalScrollBar: Bool,

Sources/LVGLBackend/LVGLBackend.swift

@@ -156,6 +156,8 @@ public final class LVGLBackend: AppBackend {
         }
     }
 
+    public func updateScrollContainer(_ scrollView: Widget, environment: EnvironmentValues) {}
+
     public func createTextView() -> Widget {
         return Widget { parent in
             let label = LVLabel(with: parent)

Sources/QtBackend/QtBackend.swift

@@ -108,6 +108,8 @@ public struct QtBackend: AppBackend {
         }
     }
 
+    public func updateScrollContainer(_ scrollView: Widget, environment: EnvironmentValues) {}
+
     public func setSpacing(ofHStack widget: Widget, to spacing: Int) {
         (widget.layout as! QHBoxLayout).spacing = Int32(spacing)
     }

Sources/SwiftCrossUI/Backend/AppBackend.swift

@@ -264,6 +264,20 @@ public protocol AppBackend {
 
     /// Creates a scrollable single-child container wrapping the given widget.
     func createScrollContainer(for child: Widget) -> Widget
+    /// Updates a scroll container with environment-specific values.
+    ///
+    /// This method is primarily used on iOS to apply environment changes
+    /// that affect the scroll view’s behavior, such as keyboard dismissal mode.
+    /// It allows the backend to update UIKit-specific properties (e.g. `keyboardDismissMode`)
+    /// when the environment changes.
+    ///
+    /// - Parameters:
+    ///   - scrollView: The scroll container widget previously created by `createScrollContainer(for:)`.
+    ///   - environment: The current `EnvironmentValues` to apply.
+    func updateScrollContainer(
+        _ scrollView: Widget,
+        environment: EnvironmentValues
+    )
     /// Sets the presence of scroll bars along each axis of a scroll container.
     func setScrollBarPresence(
         ofScrollContainer scrollView: Widget,
@@ -741,6 +755,10 @@ extension AppBackend {
         todo()
     }
 
+    public func updateScrollContainer(_ scrollView: Widget, environment: EnvironmentValues) {
+        todo()
+    }
+
     public func setScrollBarPresence(
         ofScrollContainer scrollView: Widget,
         hasVerticalScrollBar: Bool,

Sources/SwiftCrossUI/Environment/EnvironmentValues.swift

@@ -198,7 +198,7 @@ public struct EnvironmentValues {
         listStyle = .default
         toggleStyle = .button
         isEnabled = true
-        scrollDismissesKeyboardMode = .never
+        scrollDismissesKeyboardMode = .interactively
     }
 
     /// Returns a copy of the environment with the specified property set to the

Sources/SwiftCrossUI/Views/Modifiers/ScrollDismissesKeyboardModifier.swift

@@ -23,10 +23,10 @@ extension View {
     /// behavior for other kinds of scrollable views, like a ``List`` or a
     /// ``TextEditor``.
     ///
-    /// By default, scrollable content never automatically dismisses the keyboard.
+    /// By default, scrollable content dismisses the keyboard interactively as the user scrolls.
     /// Pass a different value of ``ScrollDismissesKeyboardMode`` to change this behavior.
-    /// For example, ``ScrollDismissesKeyboardMode/interactively`` allows the keyboard to dismiss
-    /// as the user scrolls. Note that ``TextEditor`` may still use a different
+    /// For example, use ``ScrollDismissesKeyboardMode/never`` to prevent the keyboard from
+    /// dismissing automatically. Note that ``TextEditor`` may still use a different
     /// default to preserve expected editing behavior.
     ///
     /// - Parameter mode: The keyboard dismissal mode that scrollable content