Add view modifier to set focus only

Documentation/Reference/extensions/View.md

@@ -165,6 +165,12 @@ Bind to the view's focus.
 - Parameter focus: Whether the view is focused.
 - Returns: A view.
 
+### `focus(_:)`
+
+Bind a signal that focuses the view.
+- Parameter focus: Whether the view is focused.
+- Returns: A view.
+
 ### `stopModifiers()`
 
 Remove all of the content modifiers for the wrapped views.

Sources/Adwaita/View/Modifiers/InspectorWrapper.swift

@@ -155,4 +155,15 @@ extension View {
         }
     }
 
+    /// Bind a signal that focuses the view.
+    /// - Parameter focus: Whether the view is focused.
+    /// - Returns: A view.
+    public func focus(_ signal: Signal) -> View {
+        inspect { storage in
+            if signal.update {
+                gtk_widget_grab_focus(storage.pointer?.cast())
+            }
+        }
+    }
+
 }

user-manual/Information/Widgets.md

@@ -48,6 +48,7 @@ There are many more widgets available using auto-generation. Learn [how to use t
 | `insensitive(_:)`                 | Make a view unable to detect actions. This is especially useful for overlays.                                                  |
 | `onClick(handler:)`               | Run a function when the user clicks on the widget.                                                                             |
 | `focused(_:)`                     | Set and observe whether a view is focused.                                                                                     |
+| `focus(_:)`                       | Bind a signal that focuses the view.                                                                                           |
 | `verticalCenter()`                | Wrap a view in a `VStack` and center vertically.                                                                               |
 | `horizontalCenter()`              | Wrap a view in an `HStack` and center horizontally.                                                                            |