fix #5278: enhance Row and ResponsiveRow documentation and improve alignment handling

Author: ndonkoHenri

packages/flet/lib/src/controls/row.dart

@@ -18,12 +18,7 @@ class RowControl extends StatelessWidget {
     debugPrint("Row build: ${control.id}");
 
     var spacing = control.getDouble("spacing", 10)!;
-    var mainAlignment = parseMainAxisAlignment(
-        control.getString("alignment"), MainAxisAlignment.start)!;
-    var tight = control.getBool("tight", false)!;
     var wrap = control.getBool("wrap", false)!;
-    var intrinsicHeight = control.getBool("intrinsic_height", false)!;
-    var verticalAlignment = control.getString("vertical_alignment");
     var controls = control.buildWidgets("controls");
 
     Widget child = wrap
@@ -35,20 +30,23 @@ class RowControl extends StatelessWidget {
                 control.getString("alignment"), WrapAlignment.start)!,
             runAlignment: parseWrapAlignment(
                 control.getString("run_alignment"), WrapAlignment.start)!,
-            crossAxisAlignment: parseWrapCrossAlignment(
-                verticalAlignment, WrapCrossAlignment.center)!,
+            crossAxisAlignment: control.getWrapCrossAlignment(
+                "vertical_alignment", WrapCrossAlignment.center)!,
             children: controls,
           )
         : Row(
             spacing: spacing,
-            mainAxisAlignment: mainAlignment,
-            mainAxisSize: tight ? MainAxisSize.min : MainAxisSize.max,
-            crossAxisAlignment: parseCrossAxisAlignment(
-                verticalAlignment, CrossAxisAlignment.center)!,
+            mainAxisSize: control.getBool("tight", false)!
+                ? MainAxisSize.min
+                : MainAxisSize.max,
+            mainAxisAlignment: control.getMainAxisAlignment(
+                "alignment", MainAxisAlignment.start)!,
+            crossAxisAlignment: control.getCrossAxisAlignment(
+                "vertical_alignment", CrossAxisAlignment.center)!,
             children: controls,
           );
 
-    if (intrinsicHeight) {
+    if (control.getBool("intrinsic_height", false)!) {
       child = IntrinsicHeight(child: child);
     }
 

sdk/python/packages/flet/src/flet/controls/core/responsive_row.py

@@ -27,6 +27,7 @@ class ResponsiveRow(LayoutControl, AdaptiveControl):
     Similar to `expand` property, every control has [`col`][flet.Control.]
     property which allows specifying how many columns a control should span.
 
+    Example:
     ```python
     ft.ResponsiveRow(
         controls=[
@@ -40,10 +41,10 @@ class ResponsiveRow(LayoutControl, AdaptiveControl):
                 },
             )
             for i in range(1, 6)
-        ], 
+        ],
     )
     ```
-    
+
     """
 
     controls: list[Control] = field(default_factory=list)
@@ -64,8 +65,13 @@ class ResponsiveRow(LayoutControl, AdaptiveControl):
 
     vertical_alignment: CrossAxisAlignment = CrossAxisAlignment.START
     """
-    Defines how the child [`controls`][(c).] should be placed
-    vertically.
+    Defines how the child [`controls`][(c).] should be placed vertically.
+
+    Note:
+        When [`wrap`][(c).] is `True`, this property doesn't support
+        [`CrossAxisAlignment.STRETCH`][flet.] or
+        [`CrossAxisAlignment.BASELINE`][flet.]. If either is used,
+        [`CrossAxisAlignment.START`][flet.] will be applied instead.
     """
 
     spacing: ResponsiveNumber = 10
@@ -80,7 +86,7 @@ class ResponsiveRow(LayoutControl, AdaptiveControl):
 
     run_spacing: ResponsiveNumber = 10
     """
-    The spacing between runs when row content is wrapped on multiple lines.
+    The spacing between runs when [`wrap`][(c).] is `True`.
     """
 
     breakpoints: dict[Union[ResponsiveRowBreakpoint, str], Number] = field(

sdk/python/packages/flet/src/flet/controls/core/row.py

@@ -18,21 +18,24 @@ class Row(LayoutControl, ScrollableControl, AdaptiveControl):
     To cause a child control to expand and fill the available horizontal space, set
     its [`expand`][(c).] property.
 
+    Example:
     ```python
-    ft.Row(
-        controls=[
-            ft.Card(
-                shape=ft.ContinuousRectangleBorder(radius=10),
-                content=ft.Container(
-                    padding=5,
-                    border_radius=ft.BorderRadius.all(5),
-                    bgcolor=ft.Colors.AMBER_100,
-                    content=ft.Text(f"Control {i}"),
-                ),
-            )
-            for i in range(1, 6)
-        ],
-    ),
+    (
+        ft.Row(
+            controls=[
+                ft.Card(
+                    shape=ft.ContinuousRectangleBorder(radius=10),
+                    content=ft.Container(
+                        padding=5,
+                        border_radius=ft.BorderRadius.all(5),
+                        bgcolor=ft.Colors.AMBER_100,
+                        content=ft.Text(f"Control {i}"),
+                    ),
+                )
+                for i in range(1, 6)
+            ],
+        ),
+    )
     ```
 
     """
@@ -50,6 +53,12 @@ class Row(LayoutControl, ScrollableControl, AdaptiveControl):
     vertical_alignment: CrossAxisAlignment = CrossAxisAlignment.CENTER
     """
     Defines how the child [`controls`][(c).] should be placed vertically.
+
+    Note:
+        When [`wrap`][(c).] is `True`, this property doesn't support
+        [`CrossAxisAlignment.STRETCH`][flet.] or
+        [`CrossAxisAlignment.BASELINE`][flet.]. If either is used,
+        [`CrossAxisAlignment.CENTER`][flet.] will be applied instead.
     """
 
     spacing: Number = 10
@@ -64,30 +73,33 @@ class Row(LayoutControl, ScrollableControl, AdaptiveControl):
 
     tight: bool = False
     """
-    Specifies how much space should be occupied horizontally.
+    Whether this row should occupy all available horizontal space (`True`),
+    or only as much as needed by its children [`controls`][(c).] (`False`).
 
-    Defaults to `False`, meaning all space is allocated to children.
+    Note:
+        Has effect only when [`wrap`][(c).] is `False`.
     """
 
     wrap: bool = False
     """
-    When set to `True` the Row will put child controls into additional rows (runs) if
-    they don't fit a single row.
+    Whether this row should put child [`controls`][(c).] into additional rows (runs) if
+    they don't fit in a single row.
     """
 
     run_spacing: Number = 10
     """
-    Spacing between runs when `wrap=True`.
+    The spacing between runs when [`wrap`][(c).] is `True`.
     """
 
     run_alignment: MainAxisAlignment = MainAxisAlignment.START
     """
-    How the runs should be placed in the cross-axis when `wrap=True`.
+    How the runs should be placed in the cross-axis when [`wrap`][(c).] is `True`.
     """
 
     intrinsic_height: bool = False
     """
-    If `True`, the Row will be as tall as the tallest child control.
+    Whether this row should be as tall as the tallest child control in
+    [`controls`][(c).].
     """
 
     def init(self):