From 10da9bea6ae1c8565880267cafcd05ed6f9bea75 Mon Sep 17 00:00:00 2001 From: Arjun-explores-Arjun-learns Date: Fri, 23 Jan 2026 18:15:52 +0530 Subject: [PATCH 1/4] docs: clarify Control layout behavior inside Containers --- tutorials/ui/gui_containers.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/tutorials/ui/gui_containers.rst b/tutorials/ui/gui_containers.rst index 166581078f2..ba10ebb9ed9 100644 --- a/tutorials/ui/gui_containers.rst +++ b/tutorials/ui/gui_containers.rst @@ -16,6 +16,14 @@ For that, :ref:`Containers ` are more useful. Container layout ---------------- +Controls inside Containers +~~~~~~~~~~~~~~~~~~~~~~~~~~ +A Control node can be laid out either manually or by a Container, depending on its context. +When a Control node is not inside a Container, its position and size are controlled using anchors, offsets, and layout presets. +When a Control node is a direct child of a Container, the Container automatically manages its layout. +In this case, manual positioning options such as anchors and presets no longer affect the Control, as the Container enforces its own layout rules. +This behavior is expected. Containers are designed to ensure consistent and predictable layout of their children. To influence layout inside Containers, + use size flags, minimum size, and the rules specific to the Container type being used. Containers provide a huge amount of layout power (as an example, the Godot editor user interface is entirely done using them): From d5da20164fe6d30da9740e28be7ed887135f9963 Mon Sep 17 00:00:00 2001 From: Arjun-figuring-out Date: Sat, 24 Jan 2026 02:12:20 +0530 Subject: [PATCH 2/4] Update tutorials/ui/gui_containers.rst Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com> --- tutorials/ui/gui_containers.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/tutorials/ui/gui_containers.rst b/tutorials/ui/gui_containers.rst index ba10ebb9ed9..758fbab3317 100644 --- a/tutorials/ui/gui_containers.rst +++ b/tutorials/ui/gui_containers.rst @@ -16,6 +16,7 @@ For that, :ref:`Containers ` are more useful. Container layout ---------------- + Controls inside Containers ~~~~~~~~~~~~~~~~~~~~~~~~~~ A Control node can be laid out either manually or by a Container, depending on its context. From 43d02ee3e44a8b4c250de5da4f7b6abac3cccae9 Mon Sep 17 00:00:00 2001 From: Arjun-figuring-out Date: Sat, 24 Jan 2026 02:12:37 +0530 Subject: [PATCH 3/4] Update tutorials/ui/gui_containers.rst Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com> --- tutorials/ui/gui_containers.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/tutorials/ui/gui_containers.rst b/tutorials/ui/gui_containers.rst index 758fbab3317..1d08ec48971 100644 --- a/tutorials/ui/gui_containers.rst +++ b/tutorials/ui/gui_containers.rst @@ -19,6 +19,7 @@ Container layout Controls inside Containers ~~~~~~~~~~~~~~~~~~~~~~~~~~ + A Control node can be laid out either manually or by a Container, depending on its context. When a Control node is not inside a Container, its position and size are controlled using anchors, offsets, and layout presets. When a Control node is a direct child of a Container, the Container automatically manages its layout. From b83121f3b414e7d1712c335e97b3e21c88d711d3 Mon Sep 17 00:00:00 2001 From: Arjun-figuring-out Date: Sat, 24 Jan 2026 02:12:49 +0530 Subject: [PATCH 4/4] Update tutorials/ui/gui_containers.rst Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com> --- tutorials/ui/gui_containers.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tutorials/ui/gui_containers.rst b/tutorials/ui/gui_containers.rst index 1d08ec48971..e50f3e8a041 100644 --- a/tutorials/ui/gui_containers.rst +++ b/tutorials/ui/gui_containers.rst @@ -25,7 +25,7 @@ When a Control node is not inside a Container, its position and size are control When a Control node is a direct child of a Container, the Container automatically manages its layout. In this case, manual positioning options such as anchors and presets no longer affect the Control, as the Container enforces its own layout rules. This behavior is expected. Containers are designed to ensure consistent and predictable layout of their children. To influence layout inside Containers, - use size flags, minimum size, and the rules specific to the Container type being used. +use size flags, minimum size, and the rules specific to the Container type being used. Containers provide a huge amount of layout power (as an example, the Godot editor user interface is entirely done using them):