v1: Rename ConstrainedControl to LayoutControl, swap Button and ElevatedButton
#5592
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Refactored all usages of ConstrainedControl to LayoutControl across control implementations. Introduced LayoutControl as the new wrapper for layout constraints, with ConstrainedControl now extending LayoutControl for backward compatibility. Updated documentation and example paths to reflect the new naming and organization.
Replaces the ElevatedButton control with Button throughout the codebase, consolidating button logic into a single Button class. ElevatedButton is now a deprecated alias for Button. Updates all usages, tests, and control registration to use Button, simplifying the API and improving maintainability.
Updated all Python example files to use ft.Button instead of ft.ElevatedButton for consistency with the latest Flet API. This affects authentication, controls-gallery, routing-navigation, studio-gallery, desktop-window-manager, and other sample apps.
Contributor
There was a problem hiding this comment.
Pull Request Overview
This PR implements a comprehensive refactoring to modernize the button control architecture in Flet. It renames ConstrainedControl to LayoutControl and swaps the roles of Button and ElevatedButton to better align with Material Design 3 guidelines.
- Renames
ConstrainedControltoLayoutControlwith a deprecated alias for backward compatibility - Makes
ElevatedButtona deprecated alias that inherits from the newButtonclass - Updates all control classes to inherit from
LayoutControlinstead ofConstrainedControl
Reviewed Changes
Copilot reviewed 280 out of 328 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
layout_control.py |
Renames ConstrainedControl to LayoutControl and adds deprecated alias |
button.py |
Moves elevated button implementation to become the main Button class |
elevated_button.py |
Converts to deprecated alias that inherits from Button |
| Various control files | Updates inheritance from ConstrainedControl to LayoutControl |
| Documentation and examples | Updates references from ElevatedButton to Button throughout |
Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.
Deploying flet-docs with
|
| Latest commit: |
81b4d48
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://cc03d05f.flet-docs.pages.dev |
| Branch Preview URL: | https://v1-layout-control.flet-docs.pages.dev |
ndonkoHenri
approved these changes
Aug 23, 2025
| ElevatedButton( | ||
| Button( | ||
| style=ft.ButtonStyle(padding=0), | ||
| text="-", |
Contributor
There was a problem hiding this comment.
Should be content over here (and in other buttons of the file) instead of text.
Can you please rename while at it?
Contributor
Author
There was a problem hiding this comment.
I've fixed this particular file, but others need more attention. Most of the examples, are either non-runnable or are in old style. I want to do a different PR and go through all examples one-by-one.
Replaces deprecated 'colors' import with 'Colors' and updates Button controls to use 'content' instead of 'text'. Also changes alignment to use MainAxisAlignment.END and updates class inheritance from UserControl to Container for improved compatibility with Flet API.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Close #5589