changelog

Author: willmcgugan

CHANGELOG.md

@@ -12,6 +12,10 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 - Fixed `TextArea` cursor display on wrapped lines https://github.com/Textualize/textual/pull/6196
 - Fixed `remove_children` not refreshing layout https://github.com/Textualize/textual/pull/6206
 
+### Added
+
+- Added `grid_size` property to `GridLayout` https://github.com/Textualize/textual/pull/6210
+
 ## [6.5.0] - 2025-10-31
 
 ### Added

src/textual/layouts/grid.py

@@ -72,8 +72,6 @@ def arrange(
 
         table_size_rows = styles.grid_size_rows
 
-        self._grid_size = (table_size_columns, table_size_rows)
-
         viewport = parent.app.viewport_size
         keyline_style, _keyline_color = styles.keyline
         offset = (0, 0)
@@ -171,9 +169,9 @@ def repeat_scalars(scalars: Iterable[Scalar], count: int) -> list[Scalar]:
             cell_coord = next_coord()
 
         column_scalars = repeat_scalars(column_scalars, table_size_columns)
-        row_scalars = repeat_scalars(
-            row_scalars, table_size_rows if table_size_rows else row + 1
-        )
+        table_size_rows = table_size_rows if table_size_rows else row + 1
+        row_scalars = repeat_scalars(row_scalars, table_size_rows)
+        self._grid_size = (table_size_columns, table_size_rows)
 
         def apply_width_limits(widget: Widget, width: int) -> int:
             """Apply min and max widths to dimension.

tests/layouts/test_grid.py

@@ -0,0 +1,34 @@
+from textual import containers, widgets
+from textual.app import App, ComposeResult
+from textual.layouts.grid import GridLayout
+
+
+async def test_grid_size():
+    """Test the `grid_size` property on GridLayout."""
+
+    class GridApp(App):
+        CSS = """
+        Grid {
+            grid-size: 3;
+            grid-columns: auto;
+            height: auto;
+            Label {
+                padding: 2 4;
+                border: blue;
+            }
+        }
+        """
+
+        def compose(self) -> ComposeResult:
+            with containers.VerticalScroll():
+                with containers.Grid():
+                    for _ in range(7):
+                        yield widgets.Label("Hello, World!")
+
+    app = GridApp()
+    async with app.run_test() as pilot:
+        await pilot.pause()
+        await app.wait_for_refresh()
+        grid_layout = app.query_one(containers.Grid).layout
+        assert isinstance(grid_layout, GridLayout)
+        assert grid_layout.grid_size == (3, 3)