flet 0.70.0.dev5620__py3-none-any.whl → 0.70.0.dev5771__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of flet might be problematic. Click here for more details.
- flet/__init__.py +2 -0
- flet/controls/adaptive_control.py +16 -13
- flet/controls/base_page.py +5 -5
- flet/controls/border.py +4 -3
- flet/controls/box.py +6 -11
- flet/controls/buttons.py +7 -7
- flet/controls/context.py +2 -2
- flet/controls/control.py +18 -11
- flet/controls/core/animated_switcher.py +9 -13
- flet/controls/core/canvas/canvas.py +1 -1
- flet/controls/core/canvas/line.py +2 -3
- flet/controls/core/canvas/oval.py +1 -1
- flet/controls/core/canvas/shape.py +10 -10
- flet/controls/core/canvas/text.py +1 -1
- flet/controls/core/column.py +5 -5
- flet/controls/core/dismissible.py +8 -8
- flet/controls/core/drag_target.py +5 -4
- flet/controls/core/draggable.py +19 -14
- flet/controls/core/grid_view.py +2 -2
- flet/controls/core/image.py +1 -1
- flet/controls/core/interactive_viewer.py +2 -2
- flet/controls/core/list_view.py +7 -7
- flet/controls/core/markdown.py +1 -1
- flet/controls/core/pagelet.py +10 -10
- flet/controls/core/reorderable_draggable.py +1 -1
- flet/controls/core/responsive_row.py +7 -7
- flet/controls/core/row.py +8 -8
- flet/controls/core/semantics.py +9 -6
- flet/controls/core/shader_mask.py +3 -3
- flet/controls/core/stack.py +4 -4
- flet/controls/core/text.py +7 -7
- flet/controls/core/text_span.py +4 -4
- flet/controls/core/transparent_pointer.py +3 -3
- flet/controls/core/view.py +16 -16
- flet/controls/core/window.py +1 -1
- flet/controls/core/window_drag_area.py +1 -1
- flet/controls/cupertino/cupertino_action_sheet.py +19 -8
- flet/controls/cupertino/cupertino_activity_indicator.py +5 -6
- flet/controls/cupertino/cupertino_alert_dialog.py +7 -10
- flet/controls/cupertino/cupertino_app_bar.py +34 -34
- flet/controls/cupertino/cupertino_bottom_sheet.py +5 -5
- flet/controls/cupertino/cupertino_button.py +4 -4
- flet/controls/cupertino/cupertino_checkbox.py +33 -40
- flet/controls/cupertino/cupertino_context_menu.py +7 -6
- flet/controls/cupertino/cupertino_context_menu_action.py +2 -4
- flet/controls/cupertino/cupertino_date_picker.py +35 -37
- flet/controls/cupertino/cupertino_dialog_action.py +12 -9
- flet/controls/cupertino/cupertino_list_tile.py +24 -36
- flet/controls/cupertino/cupertino_navigation_bar.py +10 -11
- flet/controls/cupertino/cupertino_picker.py +11 -10
- flet/controls/cupertino/cupertino_radio.py +10 -13
- flet/controls/cupertino/cupertino_segmented_button.py +9 -12
- flet/controls/cupertino/cupertino_slider.py +6 -9
- flet/controls/cupertino/cupertino_sliding_segmented_button.py +14 -17
- flet/controls/cupertino/cupertino_switch.py +30 -41
- flet/controls/cupertino/cupertino_textfield.py +14 -18
- flet/controls/cupertino/cupertino_timer_picker.py +11 -8
- flet/controls/exceptions.py +5 -5
- flet/controls/icon_data.py +2 -2
- flet/controls/keys.py +2 -1
- flet/controls/layout_control.py +22 -27
- flet/controls/material/alert_dialog.py +44 -50
- flet/controls/material/app_bar.py +41 -45
- flet/controls/material/auto_complete.py +10 -8
- flet/controls/material/badge.py +32 -28
- flet/controls/material/banner.py +14 -14
- flet/controls/material/bottom_app_bar.py +7 -9
- flet/controls/material/bottom_sheet.py +10 -10
- flet/controls/material/button.py +2 -24
- flet/controls/material/card.py +10 -11
- flet/controls/material/checkbox.py +41 -49
- flet/controls/material/chip.py +44 -47
- flet/controls/material/circle_avatar.py +19 -22
- flet/controls/material/container.py +16 -123
- flet/controls/material/datatable.py +71 -95
- flet/controls/material/date_picker.py +13 -14
- flet/controls/material/date_range_picker.py +183 -0
- flet/controls/material/divider.py +24 -23
- flet/controls/material/dropdown.py +21 -13
- flet/controls/material/expansion_tile.py +5 -6
- flet/controls/material/filled_button.py +1 -1
- flet/controls/material/floating_action_button.py +2 -2
- flet/controls/material/form_field_control.py +64 -56
- flet/controls/material/icon_button.py +29 -65
- flet/controls/material/list_tile.py +41 -32
- flet/controls/material/menu_item_button.py +2 -2
- flet/controls/material/navigation_bar.py +3 -3
- flet/controls/material/navigation_rail.py +11 -11
- flet/controls/material/outlined_button.py +1 -1
- flet/controls/material/popup_menu_button.py +3 -3
- flet/controls/material/progress_bar.py +15 -22
- flet/controls/material/progress_ring.py +8 -8
- flet/controls/material/radio.py +3 -8
- flet/controls/material/range_slider.py +1 -1
- flet/controls/material/search_bar.py +15 -16
- flet/controls/material/segmented_button.py +4 -4
- flet/controls/material/selection_area.py +4 -3
- flet/controls/material/slider.py +16 -16
- flet/controls/material/snack_bar.py +33 -32
- flet/controls/material/submenu_button.py +9 -9
- flet/controls/material/switch.py +13 -13
- flet/controls/material/tabs.py +77 -78
- flet/controls/material/text_button.py +2 -2
- flet/controls/material/textfield.py +4 -6
- flet/controls/material/tooltip.py +16 -15
- flet/controls/material/vertical_divider.py +10 -10
- flet/controls/page.py +4 -4
- flet/controls/painting.py +2 -2
- flet/controls/scrollable_control.py +1 -1
- flet/controls/services/file_picker.py +7 -7
- flet/controls/services/haptic_feedback.py +1 -1
- flet/controls/services/shake_detector.py +1 -1
- flet/controls/services/storage_paths.py +3 -3
- flet/controls/text_style.py +1 -1
- flet/controls/theme.py +669 -608
- flet/controls/types.py +11 -11
- flet/testing/flet_test_app.py +4 -4
- flet/version.py +1 -1
- {flet-0.70.0.dev5620.dist-info → flet-0.70.0.dev5771.dist-info}/METADATA +5 -5
- flet-0.70.0.dev5771.dist-info/RECORD +239 -0
- flet-0.70.0.dev5620.dist-info/RECORD +0 -238
- {flet-0.70.0.dev5620.dist-info → flet-0.70.0.dev5771.dist-info}/WHEEL +0 -0
- {flet-0.70.0.dev5620.dist-info → flet-0.70.0.dev5771.dist-info}/entry_points.txt +0 -0
- {flet-0.70.0.dev5620.dist-info → flet-0.70.0.dev5771.dist-info}/top_level.txt +0 -0
|
@@ -30,6 +30,14 @@ class ListTileTitleAlignment(Enum):
|
|
|
30
30
|
|
|
31
31
|
|
|
32
32
|
class ListTileStyle(Enum):
|
|
33
|
+
"""
|
|
34
|
+
Defines the title font used for ListTile descendants of a ListTileTheme.
|
|
35
|
+
|
|
36
|
+
List tiles that appear in a Drawer use the theme's TextTheme.body_large text style,
|
|
37
|
+
which is a little smaller than the theme's TextTheme.title_medium text style, which
|
|
38
|
+
is used by default.
|
|
39
|
+
"""
|
|
40
|
+
|
|
33
41
|
LIST = "list"
|
|
34
42
|
DRAWER = "drawer"
|
|
35
43
|
|
|
@@ -45,24 +53,24 @@ class ListTile(LayoutControl, AdaptiveControl):
|
|
|
45
53
|
"""
|
|
46
54
|
A control to display as primary content of the list tile.
|
|
47
55
|
|
|
48
|
-
Typically a [`Text`][flet.
|
|
49
|
-
wrap. To enforce the single line limit, use [`Text.max_lines`][flet.
|
|
56
|
+
Typically a [`Text`][flet.] control. This should not
|
|
57
|
+
wrap. To enforce the single line limit, use [`Text.max_lines`][flet.].
|
|
50
58
|
"""
|
|
51
59
|
|
|
52
60
|
subtitle: Optional[StrOrControl] = None
|
|
53
61
|
"""
|
|
54
62
|
Additional content displayed below the title.
|
|
55
63
|
|
|
56
|
-
If [`is_three_line`][
|
|
64
|
+
If [`is_three_line`][(c).] is `False`, this should not wrap.
|
|
57
65
|
If `is_three_line` is `True`, this should be configured to take a maximum of two
|
|
58
66
|
lines.
|
|
59
|
-
For example, you can use [`Text.max_lines`][flet.
|
|
67
|
+
For example, you can use [`Text.max_lines`][flet.] to enforce the
|
|
60
68
|
number of lines.
|
|
61
69
|
|
|
62
|
-
Typically a [`Text`][flet.
|
|
70
|
+
Typically a [`Text`][flet.] control.
|
|
63
71
|
"""
|
|
64
72
|
|
|
65
|
-
is_three_line: bool =
|
|
73
|
+
is_three_line: Optional[bool] = None
|
|
66
74
|
"""
|
|
67
75
|
Whether this list tile is intended to display three lines of text.
|
|
68
76
|
|
|
@@ -73,19 +81,19 @@ class ListTile(LayoutControl, AdaptiveControl):
|
|
|
73
81
|
treated as having two lines if the subtitle is non-null.
|
|
74
82
|
|
|
75
83
|
When using a Text control for title and subtitle, you can enforce line limits
|
|
76
|
-
using [`Text.max_lines`][flet.
|
|
84
|
+
using [`Text.max_lines`][flet.].
|
|
77
85
|
"""
|
|
78
86
|
|
|
79
87
|
leading: Optional[IconDataOrControl] = None
|
|
80
88
|
"""
|
|
81
|
-
A control to display before the [`title`][
|
|
89
|
+
A control to display before the [`title`][(c).].
|
|
82
90
|
"""
|
|
83
91
|
|
|
84
92
|
trailing: Optional[IconDataOrControl] = None
|
|
85
93
|
"""
|
|
86
|
-
A control to display after the [`title`][
|
|
94
|
+
A control to display after the [`title`][(c).].
|
|
87
95
|
|
|
88
|
-
Typically an [`Icon`][flet.
|
|
96
|
+
Typically an [`Icon`][flet.] control.
|
|
89
97
|
"""
|
|
90
98
|
|
|
91
99
|
content_padding: Optional[PaddingValue] = None
|
|
@@ -100,15 +108,16 @@ class ListTile(LayoutControl, AdaptiveControl):
|
|
|
100
108
|
The list tile's background color.
|
|
101
109
|
"""
|
|
102
110
|
|
|
103
|
-
|
|
111
|
+
splash_color: Optional[ColorValue] = None
|
|
104
112
|
"""
|
|
105
|
-
The list tile's splash color after the
|
|
106
|
-
being was tapped.
|
|
113
|
+
The list tile's splash color after the control has been tapped.
|
|
107
114
|
"""
|
|
108
115
|
|
|
109
116
|
hover_color: Optional[ColorValue] = None
|
|
110
117
|
"""
|
|
111
|
-
The tile's color when hovered.
|
|
118
|
+
The tile's color when hovered. Only takes effect if
|
|
119
|
+
[`toggle_inputs`][(c).] is True or if
|
|
120
|
+
[`on_click`][(c).] is provided.
|
|
112
121
|
"""
|
|
113
122
|
|
|
114
123
|
selected: bool = False
|
|
@@ -117,7 +126,7 @@ class ListTile(LayoutControl, AdaptiveControl):
|
|
|
117
126
|
By default the selected color is the theme's primary color.
|
|
118
127
|
"""
|
|
119
128
|
|
|
120
|
-
dense: bool =
|
|
129
|
+
dense: Optional[bool] = None
|
|
121
130
|
"""
|
|
122
131
|
Whether this list tile is part of a vertically dense list.
|
|
123
132
|
|
|
@@ -133,8 +142,8 @@ class ListTile(LayoutControl, AdaptiveControl):
|
|
|
133
142
|
|
|
134
143
|
toggle_inputs: bool = False
|
|
135
144
|
"""
|
|
136
|
-
Whether clicking on a list tile should toggle the state of [`Radio`][flet.
|
|
137
|
-
[`Checkbox`][flet.
|
|
145
|
+
Whether clicking on a list tile should toggle the state of [`Radio`][flet.],
|
|
146
|
+
[`Checkbox`][flet.] or [`Switch`][flet.] inside this tile.
|
|
138
147
|
"""
|
|
139
148
|
|
|
140
149
|
selected_color: Optional[ColorValue] = None
|
|
@@ -156,26 +165,26 @@ class ListTile(LayoutControl, AdaptiveControl):
|
|
|
156
165
|
Defaults to `ListTileStyle.LIST`.
|
|
157
166
|
"""
|
|
158
167
|
|
|
159
|
-
enable_feedback: bool =
|
|
168
|
+
enable_feedback: Optional[bool] = None
|
|
160
169
|
"""
|
|
161
170
|
Whether detected gestures should provide acoustic and/or haptic feedback.
|
|
162
171
|
On Android, for example, setting this to `True` produce a click sound and a
|
|
163
172
|
long-press will produce a short vibration.
|
|
164
173
|
"""
|
|
165
174
|
|
|
166
|
-
horizontal_spacing: Number =
|
|
175
|
+
horizontal_spacing: Optional[Number] = None
|
|
167
176
|
"""
|
|
168
177
|
The horizontal gap between the `title` and the
|
|
169
|
-
[`leading`][
|
|
178
|
+
[`leading`][(c).] and [`trailing`][(c).]
|
|
170
179
|
controls.
|
|
171
180
|
"""
|
|
172
181
|
|
|
173
|
-
min_leading_width: Number =
|
|
182
|
+
min_leading_width: Optional[Number] = None
|
|
174
183
|
"""
|
|
175
184
|
The minimum width allocated for the `leading` control.
|
|
176
185
|
"""
|
|
177
186
|
|
|
178
|
-
min_vertical_padding: Number =
|
|
187
|
+
min_vertical_padding: Optional[Number] = None
|
|
179
188
|
"""
|
|
180
189
|
The minimum padding on the top and bottom of the `title` and `subtitle` controls.
|
|
181
190
|
"""
|
|
@@ -184,7 +193,7 @@ class ListTile(LayoutControl, AdaptiveControl):
|
|
|
184
193
|
"""
|
|
185
194
|
The URL to open when this button is clicked.
|
|
186
195
|
|
|
187
|
-
Additionally, if [`on_click`][
|
|
196
|
+
Additionally, if [`on_click`][(c).] event callback is provided,
|
|
188
197
|
it is fired after that.
|
|
189
198
|
"""
|
|
190
199
|
|
|
@@ -200,15 +209,15 @@ class ListTile(LayoutControl, AdaptiveControl):
|
|
|
200
209
|
icon_color: Optional[ColorValue] = None
|
|
201
210
|
"""
|
|
202
211
|
Defines the default color for the icons
|
|
203
|
-
present in [`leading`][
|
|
204
|
-
[`trailing`][
|
|
212
|
+
present in [`leading`][(c).] and
|
|
213
|
+
[`trailing`][(c).].
|
|
205
214
|
"""
|
|
206
215
|
|
|
207
216
|
text_color: Optional[ColorValue] = None
|
|
208
217
|
"""
|
|
209
218
|
The color used for
|
|
210
|
-
texts in [`title`][
|
|
211
|
-
[`leading`][
|
|
219
|
+
texts in [`title`][(c).], [`subtitle`][(c).],
|
|
220
|
+
[`leading`][(c).], and [`trailing`][(c).].
|
|
212
221
|
"""
|
|
213
222
|
|
|
214
223
|
shape: Optional[OutlinedBorder] = None
|
|
@@ -224,25 +233,25 @@ class ListTile(LayoutControl, AdaptiveControl):
|
|
|
224
233
|
mouse_cursor: Optional[MouseCursor] = None
|
|
225
234
|
"""
|
|
226
235
|
The cursor to be displayed when a mouse pointer enters or is hovering over this
|
|
227
|
-
control. The value is [`MouseCursor`][flet.
|
|
236
|
+
control. The value is [`MouseCursor`][flet.]
|
|
228
237
|
enum.
|
|
229
238
|
"""
|
|
230
239
|
|
|
231
240
|
title_text_style: Optional[TextStyle] = None
|
|
232
241
|
"""
|
|
233
|
-
The [`TextStyle`][flet.
|
|
242
|
+
The [`TextStyle`][flet.] for the [`title`][(c).]
|
|
234
243
|
control.
|
|
235
244
|
"""
|
|
236
245
|
|
|
237
246
|
subtitle_text_style: Optional[TextStyle] = None
|
|
238
247
|
"""
|
|
239
|
-
The [`TextStyle`][flet.
|
|
248
|
+
The [`TextStyle`][flet.] for the
|
|
240
249
|
`subtitle` control.
|
|
241
250
|
"""
|
|
242
251
|
|
|
243
252
|
leading_and_trailing_text_style: Optional[TextStyle] = None
|
|
244
253
|
"""
|
|
245
|
-
The [`TextStyle`][flet.
|
|
254
|
+
The [`TextStyle`][flet.] for the
|
|
246
255
|
`leading` and `trailing` controls.
|
|
247
256
|
"""
|
|
248
257
|
|
|
@@ -252,7 +261,7 @@ class ListTile(LayoutControl, AdaptiveControl):
|
|
|
252
261
|
|
|
253
262
|
If `None` or not set, default tile heights are `56.0`, `72.0`, and `88.0` for one,
|
|
254
263
|
two, and three lines of text respectively.
|
|
255
|
-
If [`dense`][
|
|
264
|
+
If [`dense`][(c).] is `True`, these
|
|
256
265
|
defaults are changed to `48.0`, `64.0`, and `76.0`.
|
|
257
266
|
|
|
258
267
|
Note that, a visual density value or a large title will also adjust the default
|
|
@@ -39,14 +39,14 @@ class MenuItemButton(LayoutControl):
|
|
|
39
39
|
"""
|
|
40
40
|
An optional control to display before the `content`.
|
|
41
41
|
|
|
42
|
-
Typically an [`Icon`][flet.
|
|
42
|
+
Typically an [`Icon`][flet.] control.
|
|
43
43
|
"""
|
|
44
44
|
|
|
45
45
|
trailing: Optional[Control] = None
|
|
46
46
|
"""
|
|
47
47
|
An optional control to display after the `content`.
|
|
48
48
|
|
|
49
|
-
Typically an [`Icon`][flet.
|
|
49
|
+
Typically an [`Icon`][flet.] control.
|
|
50
50
|
"""
|
|
51
51
|
|
|
52
52
|
clip_behavior: ClipBehavior = ClipBehavior.NONE
|
|
@@ -130,7 +130,7 @@ class NavigationBar(LayoutControl, AdaptiveControl):
|
|
|
130
130
|
label_padding: Optional[PaddingValue] = None
|
|
131
131
|
"""
|
|
132
132
|
The padding around the
|
|
133
|
-
[`NavigationBarDestination.label`][flet.
|
|
133
|
+
[`NavigationBarDestination.label`][flet.].
|
|
134
134
|
"""
|
|
135
135
|
|
|
136
136
|
elevation: Optional[Number] = None
|
|
@@ -168,9 +168,9 @@ class NavigationBar(LayoutControl, AdaptiveControl):
|
|
|
168
168
|
overlay_color: Optional[ControlStateValue[ColorValue]] = None
|
|
169
169
|
"""
|
|
170
170
|
The highlight color of the `NavigationBarDestination` in various
|
|
171
|
-
[`ControlState`][flet.
|
|
171
|
+
[`ControlState`][flet.] states.
|
|
172
172
|
|
|
173
|
-
The following [`ControlState`][flet.
|
|
173
|
+
The following [`ControlState`][flet.]
|
|
174
174
|
values are supported: `PRESSED`, `HOVERED` and `FOCUSED`.
|
|
175
175
|
"""
|
|
176
176
|
|
|
@@ -66,7 +66,7 @@ class NavigationRailDestination(Control):
|
|
|
66
66
|
indicator_color: Optional[ColorValue] = None
|
|
67
67
|
"""
|
|
68
68
|
The color of the
|
|
69
|
-
[`indicator_shape`][
|
|
69
|
+
[`indicator_shape`][(c).] when
|
|
70
70
|
this destination is selected.
|
|
71
71
|
"""
|
|
72
72
|
|
|
@@ -153,7 +153,7 @@ class NavigationRail(LayoutControl):
|
|
|
153
153
|
|
|
154
154
|
Its location is not affected by `group_alignment`.
|
|
155
155
|
|
|
156
|
-
Typically a [`FloatingActionButton`][flet.
|
|
156
|
+
Typically a [`FloatingActionButton`][flet.], but
|
|
157
157
|
may also be a non-button, such as a logo.
|
|
158
158
|
"""
|
|
159
159
|
|
|
@@ -204,7 +204,7 @@ class NavigationRail(LayoutControl):
|
|
|
204
204
|
|
|
205
205
|
selected_label_text_style: Optional[TextStyle] = None
|
|
206
206
|
"""
|
|
207
|
-
The [`TextStyle`][flet.
|
|
207
|
+
The [`TextStyle`][flet.] of a
|
|
208
208
|
destination's label when it is selected.
|
|
209
209
|
|
|
210
210
|
When a destination is not selected, `unselected_label_text_style` will instead be
|
|
@@ -213,7 +213,7 @@ class NavigationRail(LayoutControl):
|
|
|
213
213
|
|
|
214
214
|
unselected_label_text_style: Optional[TextStyle] = None
|
|
215
215
|
"""
|
|
216
|
-
The [`TextStyle`][flet.
|
|
216
|
+
The [`TextStyle`][flet.] of a
|
|
217
217
|
destination's label when it is not selected.
|
|
218
218
|
|
|
219
219
|
When a destination is selected, `selected_label_text_style` will instead be used.
|
|
@@ -223,15 +223,15 @@ class NavigationRail(LayoutControl):
|
|
|
223
223
|
"""
|
|
224
224
|
Whether to add a rounded navigation indicator behind the selected destination's icon.
|
|
225
225
|
|
|
226
|
-
The indicator's shape will be circular if [`label_type`][
|
|
227
|
-
is [`NavigationRailLabelType.NONE`][flet.
|
|
228
|
-
[`StadiumBorder`][flet.
|
|
229
|
-
is [`NavigationRailLabelType.ALL`][flet.
|
|
230
|
-
[`NavigationRailLabelType.SELECTED`][flet.
|
|
226
|
+
The indicator's shape will be circular if [`label_type`][(c).]
|
|
227
|
+
is [`NavigationRailLabelType.NONE`][flet.], or a
|
|
228
|
+
[`StadiumBorder`][flet.] if [`label_type`][(c).]
|
|
229
|
+
is [`NavigationRailLabelType.ALL`][flet.] or
|
|
230
|
+
[`NavigationRailLabelType.SELECTED`][flet.].
|
|
231
231
|
|
|
232
232
|
If `None`, defaults to
|
|
233
|
-
[`NavigationRailTheme.use_indicator`][flet.
|
|
234
|
-
If that is also `None`, defaults to [`Theme.use_material3`][flet.
|
|
233
|
+
[`NavigationRailTheme.use_indicator`][flet.].
|
|
234
|
+
If that is also `None`, defaults to [`Theme.use_material3`][flet.].
|
|
235
235
|
""" # noqa: E501
|
|
236
236
|
|
|
237
237
|
on_change: Optional[ControlEventHandler["NavigationRail"]] = None
|
|
@@ -61,7 +61,7 @@ class OutlinedButton(LayoutControl, AdaptiveControl):
|
|
|
61
61
|
"""
|
|
62
62
|
The URL to open when this button is clicked.
|
|
63
63
|
|
|
64
|
-
Additionally, if [`on_click`][
|
|
64
|
+
Additionally, if [`on_click`][(c).] event callback is
|
|
65
65
|
provided, it is fired after that.
|
|
66
66
|
"""
|
|
67
67
|
|
|
@@ -43,7 +43,7 @@ class PopupMenuItem(Control):
|
|
|
43
43
|
Whether this menu item is checked.
|
|
44
44
|
|
|
45
45
|
If set to `True`, a checkmark will be shown on the left of the
|
|
46
|
-
[`content`][
|
|
46
|
+
[`content`][(c).].
|
|
47
47
|
"""
|
|
48
48
|
|
|
49
49
|
height: Number = 48.0
|
|
@@ -58,11 +58,11 @@ class PopupMenuItem(Control):
|
|
|
58
58
|
Defaults to `Padding.symmetric(horizontal=12)`.
|
|
59
59
|
|
|
60
60
|
Note:
|
|
61
|
-
The [`height`][
|
|
61
|
+
The [`height`][(c).] value of this menu item may
|
|
62
62
|
influence the applied padding.
|
|
63
63
|
|
|
64
64
|
For example, if a `height` greater than the height of the sum of the padding
|
|
65
|
-
and a [`content`][
|
|
65
|
+
and a [`content`][(c).] is provided, then the padding's
|
|
66
66
|
effect will not be visible.
|
|
67
67
|
"""
|
|
68
68
|
|
|
@@ -64,28 +64,23 @@ class ProgressBar(LayoutControl):
|
|
|
64
64
|
"""
|
|
65
65
|
The color of the stop indicator.
|
|
66
66
|
|
|
67
|
-
If [`ProgressBar.
|
|
68
|
-
|
|
69
|
-
indicator will be drawn.
|
|
67
|
+
If [`ProgressBar.year_2023`][flet.] is `True` or [`Theme.use_material3`][flet.]
|
|
68
|
+
is `False`, then no stop indicator will be drawn.
|
|
70
69
|
|
|
71
|
-
If not set, then the
|
|
72
|
-
[`
|
|
73
|
-
will be used. If that is not set, then the
|
|
74
|
-
[`ColorScheme.primary`][flet.ColorScheme.primary] will be used.
|
|
70
|
+
If not set, then the [`ProgressIndicatorTheme.stop_indicator_color`][flet.] will
|
|
71
|
+
be used. If that is not set, then the [`ColorScheme.primary`][flet.] will be used.
|
|
75
72
|
"""
|
|
76
73
|
|
|
77
74
|
stop_indicator_radius: Optional[Number] = None
|
|
78
75
|
"""
|
|
79
76
|
The radius of the stop indicator.
|
|
80
77
|
|
|
81
|
-
If [`ProgressBar.
|
|
82
|
-
|
|
83
|
-
indicator will be drawn.
|
|
78
|
+
If [`ProgressBar.year_2023`][flet.] is `True` or [`Theme.use_material3`][flet.] is
|
|
79
|
+
`False`, then no stop indicator will be drawn.
|
|
84
80
|
|
|
85
81
|
Set `stop_indicator_radius` to `0` to hide the stop indicator.
|
|
86
82
|
|
|
87
|
-
If not set, then the
|
|
88
|
-
[`ProgressIndicatorTheme.stop_indicator_radius`][flet.ProgressIndicatorTheme.stop_indicator_radius]
|
|
83
|
+
If not set, then the [`ProgressIndicatorTheme.stop_indicator_radius`][flet.]
|
|
89
84
|
will be used. If that is not set, then defaults to `2`.
|
|
90
85
|
"""
|
|
91
86
|
|
|
@@ -93,15 +88,15 @@ class ProgressBar(LayoutControl):
|
|
|
93
88
|
"""
|
|
94
89
|
The gap between the indicator and the track.
|
|
95
90
|
|
|
96
|
-
If [`ProgressBar.
|
|
97
|
-
[`Theme.use_material3`][flet.
|
|
91
|
+
If [`ProgressBar.year_2023`][flet.] is `True` or
|
|
92
|
+
[`Theme.use_material3`][flet.] is `False`, then no track gap
|
|
98
93
|
will be drawn.
|
|
99
94
|
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
If not set, then the
|
|
103
|
-
[`ProgressIndicatorTheme.track_gap`][flet.ProgressIndicatorTheme.track_gap] will be
|
|
95
|
+
If not set, then the [`ProgressIndicatorTheme.track_gap`][flet.] will be
|
|
104
96
|
used. If that is not set, then defaults to `4`.
|
|
97
|
+
|
|
98
|
+
Tip:
|
|
99
|
+
Set `track_gap` to `0` to hide the track gap.
|
|
105
100
|
"""
|
|
106
101
|
|
|
107
102
|
year_2023: Optional[bool] = None
|
|
@@ -111,12 +106,10 @@ class ProgressBar(LayoutControl):
|
|
|
111
106
|
|
|
112
107
|
When `True`, the ProgressBar will use the 2023 Material Design 3 appearance.
|
|
113
108
|
|
|
114
|
-
If not set, then the
|
|
115
|
-
[`ProgressIndicatorTheme.year_2023`][flet.ProgressIndicatorTheme.year_2023] will be
|
|
109
|
+
If not set, then the [`ProgressIndicatorTheme.year_2023`][flet.] will be
|
|
116
110
|
used, which is `False` by default.
|
|
117
111
|
|
|
118
|
-
If [`Theme.use_material3`][flet.
|
|
119
|
-
is ignored.
|
|
112
|
+
If [`Theme.use_material3`][flet.] is `False`, then this property is ignored.
|
|
120
113
|
"""
|
|
121
114
|
|
|
122
115
|
def before_update(self):
|
|
@@ -53,7 +53,7 @@ class ProgressRing(LayoutControl):
|
|
|
53
53
|
|
|
54
54
|
A value of 0 (center stroke) will center the border on the edge of the control.
|
|
55
55
|
|
|
56
|
-
If [`ProgressRing.year_2023`][flet.
|
|
56
|
+
If [`ProgressRing.year_2023`][flet.] is `True`, then the
|
|
57
57
|
default value is `0`. Otherwise, the default value is `-1`.
|
|
58
58
|
"""
|
|
59
59
|
|
|
@@ -77,13 +77,13 @@ class ProgressRing(LayoutControl):
|
|
|
77
77
|
"""
|
|
78
78
|
The gap between the active indicator and the background track.
|
|
79
79
|
|
|
80
|
-
If [`year_2023`][
|
|
80
|
+
If [`year_2023`][(c).] is `True` or `Theme.use_material3` is
|
|
81
81
|
`False`, then no track gap will be drawn.
|
|
82
82
|
|
|
83
83
|
Set `track_gap` to `0` to hide this track gap.
|
|
84
84
|
|
|
85
85
|
If `None`,
|
|
86
|
-
[`ProgressIndicatorTheme.track_gap`][flet.
|
|
86
|
+
[`ProgressIndicatorTheme.track_gap`][flet.] is used.
|
|
87
87
|
|
|
88
88
|
If that's is also `None`, defaults to `4.0`.
|
|
89
89
|
"""
|
|
@@ -93,7 +93,7 @@ class ProgressRing(LayoutControl):
|
|
|
93
93
|
Defines the minimum and maximum size of the progress indicator.
|
|
94
94
|
|
|
95
95
|
If `None`,
|
|
96
|
-
[`ProgressIndicatorTheme.size_constraints`][flet.
|
|
96
|
+
[`ProgressIndicatorTheme.size_constraints`][flet.]
|
|
97
97
|
is used.
|
|
98
98
|
|
|
99
99
|
If that's is also `None`, defaults to a minimum width and height of `36`.
|
|
@@ -104,10 +104,10 @@ class ProgressRing(LayoutControl):
|
|
|
104
104
|
The padding around the indicator track.
|
|
105
105
|
|
|
106
106
|
If `None`,
|
|
107
|
-
[`ProgressIndicatorTheme.circular_track_padding`][flet.
|
|
107
|
+
[`ProgressIndicatorTheme.circular_track_padding`][flet.]
|
|
108
108
|
is used.
|
|
109
109
|
|
|
110
|
-
If that's is also `None` and [`year_2023`][
|
|
110
|
+
If that's is also `None` and [`year_2023`][(c).] is `False`,
|
|
111
111
|
defaults to `Padding.all(4.0)`.
|
|
112
112
|
|
|
113
113
|
Otherwise, defaults to `Padding.all(0.0)`.
|
|
@@ -121,9 +121,9 @@ class ProgressRing(LayoutControl):
|
|
|
121
121
|
When `True`, the `ProgressRing` will use the 2023 Material Design 3 appearance.
|
|
122
122
|
|
|
123
123
|
If not set, then the
|
|
124
|
-
[`ProgressIndicatorTheme.year_2023`][flet.
|
|
124
|
+
[`ProgressIndicatorTheme.year_2023`][flet.] will be
|
|
125
125
|
used, which is `False` by default.
|
|
126
126
|
|
|
127
|
-
If [`Theme.use_material3`][flet.
|
|
127
|
+
If [`Theme.use_material3`][flet.] is `False`, then this property
|
|
128
128
|
is ignored.
|
|
129
129
|
"""
|
flet/controls/material/radio.py
CHANGED
|
@@ -53,22 +53,17 @@ class Radio(LayoutControl, AdaptiveControl):
|
|
|
53
53
|
|
|
54
54
|
fill_color: Optional[ControlStateValue[ColorValue]] = None
|
|
55
55
|
"""
|
|
56
|
-
The color that fills the radio, in all or
|
|
57
|
-
specific [`ControlState`][flet.ControlState]
|
|
58
|
-
states.
|
|
56
|
+
The color that fills the radio, in all or specific [`ControlState`][flet.] states.
|
|
59
57
|
"""
|
|
60
58
|
|
|
61
59
|
active_color: Optional[ColorValue] = None
|
|
62
60
|
"""
|
|
63
|
-
The color used to fill this radio when it
|
|
64
|
-
is selected.
|
|
61
|
+
The color used to fill this radio when it is selected.
|
|
65
62
|
"""
|
|
66
63
|
|
|
67
64
|
overlay_color: Optional[ControlStateValue[ColorValue]] = None
|
|
68
65
|
"""
|
|
69
|
-
The overlay color of this radio in all or
|
|
70
|
-
specific [`ControlState`][flet.ControlState]
|
|
71
|
-
states.
|
|
66
|
+
The overlay color of this radio in all or specific [`ControlState`][flet.] states.
|
|
72
67
|
"""
|
|
73
68
|
|
|
74
69
|
hover_color: Optional[ColorValue] = None
|
|
@@ -100,7 +100,7 @@ class RangeSlider(LayoutControl):
|
|
|
100
100
|
"""
|
|
101
101
|
The highlight color that's typically
|
|
102
102
|
used to indicate that the range slider thumb is in `HOVERED` or `DRAGGED`
|
|
103
|
-
[`ControlState`][flet.
|
|
103
|
+
[`ControlState`][flet.] .
|
|
104
104
|
"""
|
|
105
105
|
|
|
106
106
|
mouse_cursor: Optional[ControlStateValue[MouseCursor]] = None
|
|
@@ -30,8 +30,8 @@ class SearchBar(LayoutControl):
|
|
|
30
30
|
controls: list[Control] = field(default_factory=list)
|
|
31
31
|
"""
|
|
32
32
|
The list of controls to be displayed below the search bar when in search view.
|
|
33
|
-
These controls are usually [`ListTile`][flet.
|
|
34
|
-
in a [`ListView`][flet.
|
|
33
|
+
These controls are usually [`ListTile`][flet.]s and will be displayed
|
|
34
|
+
in a [`ListView`][flet.].
|
|
35
35
|
"""
|
|
36
36
|
|
|
37
37
|
value: str = ""
|
|
@@ -57,23 +57,22 @@ class SearchBar(LayoutControl):
|
|
|
57
57
|
bar_hint_text: Optional[str] = None
|
|
58
58
|
"""
|
|
59
59
|
Defines the text to be shown in the search bar when it is empty and the search
|
|
60
|
-
view is close.
|
|
61
|
-
|
|
60
|
+
view is close.
|
|
61
|
+
|
|
62
|
+
Usually some text that suggests what sort of input the field accepts.
|
|
62
63
|
"""
|
|
63
64
|
|
|
64
65
|
bar_bgcolor: Optional[ControlStateValue[ColorValue]] = None
|
|
65
66
|
"""
|
|
66
|
-
Defines the background color of the
|
|
67
|
-
|
|
68
|
-
[`ControlState`][flet.ControlState] states.
|
|
67
|
+
Defines the background color of the search bar in all or specific
|
|
68
|
+
[`ControlState`][flet.] states.
|
|
69
69
|
"""
|
|
70
70
|
|
|
71
71
|
bar_overlay_color: Optional[ControlStateValue[ColorValue]] = None
|
|
72
72
|
"""
|
|
73
|
-
Defines the highlight color that's
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
states.
|
|
73
|
+
Defines the highlight color that's typically used to indicate that the
|
|
74
|
+
search bar is in [`FOCUSED`][flet.ControlState.], [`HOVERED`][flet.ControlState.],
|
|
75
|
+
or [`PRESSED`][flet.ControlState.] states.
|
|
77
76
|
"""
|
|
78
77
|
|
|
79
78
|
bar_shadow_color: Optional[ControlStateValue[ColorValue]] = None
|
|
@@ -90,7 +89,7 @@ class SearchBar(LayoutControl):
|
|
|
90
89
|
"""
|
|
91
90
|
The color and weight of the search bar's outline.
|
|
92
91
|
|
|
93
|
-
This value is combined with [`SearchBar.bar_shape`][flet.
|
|
92
|
+
This value is combined with [`SearchBar.bar_shape`][flet.] to
|
|
94
93
|
create a shape decorated with an outline.
|
|
95
94
|
"""
|
|
96
95
|
|
|
@@ -99,7 +98,7 @@ class SearchBar(LayoutControl):
|
|
|
99
98
|
The shape of the search bar.
|
|
100
99
|
|
|
101
100
|
This shape is combined with
|
|
102
|
-
[`SearchBar.bar_border_side`][flet.
|
|
101
|
+
[`SearchBar.bar_border_side`][flet.] to create a shape
|
|
103
102
|
decorated with an outline.
|
|
104
103
|
"""
|
|
105
104
|
|
|
@@ -110,7 +109,7 @@ class SearchBar(LayoutControl):
|
|
|
110
109
|
|
|
111
110
|
bar_hint_text_style: Optional[ControlStateValue[TextStyle]] = None
|
|
112
111
|
"""
|
|
113
|
-
The style to use for the [`SearchBar.bar_hint_text`][flet.
|
|
112
|
+
The style to use for the [`SearchBar.bar_hint_text`][flet.].
|
|
114
113
|
"""
|
|
115
114
|
|
|
116
115
|
bar_padding: Optional[ControlStateValue[PaddingValue]] = None
|
|
@@ -176,13 +175,13 @@ class SearchBar(LayoutControl):
|
|
|
176
175
|
|
|
177
176
|
view_header_text_style: Optional[TextStyle] = None
|
|
178
177
|
"""
|
|
179
|
-
Defines the [`TextStyle`][flet.
|
|
178
|
+
Defines the [`TextStyle`][flet.] of the
|
|
180
179
|
text being edited on the search view.
|
|
181
180
|
"""
|
|
182
181
|
|
|
183
182
|
view_hint_text_style: Optional[TextStyle] = None
|
|
184
183
|
"""
|
|
185
|
-
Defines the [`TextStyle`][flet.
|
|
184
|
+
Defines the [`TextStyle`][flet.] of
|
|
186
185
|
`view_hint_text`.
|
|
187
186
|
"""
|
|
188
187
|
|
|
@@ -20,7 +20,7 @@ __all__ = ["Segment", "SegmentedButton"]
|
|
|
20
20
|
@control("Segment")
|
|
21
21
|
class Segment(Control):
|
|
22
22
|
"""
|
|
23
|
-
A segment for a [`SegmentedButton`][flet.
|
|
23
|
+
A segment for a [`SegmentedButton`][flet.].
|
|
24
24
|
|
|
25
25
|
Raises:
|
|
26
26
|
AssertionError: If neither [`icon`][(c).] nor [`label`][(c).] is set.
|
|
@@ -33,13 +33,13 @@ class Segment(Control):
|
|
|
33
33
|
|
|
34
34
|
icon: Optional[IconDataOrControl] = None
|
|
35
35
|
"""
|
|
36
|
-
The icon (typically an [`Icon`][flet.
|
|
36
|
+
The icon (typically an [`Icon`][flet.]) to be
|
|
37
37
|
displayed in the segment.
|
|
38
38
|
"""
|
|
39
39
|
|
|
40
40
|
label: Optional[StrOrControl] = None
|
|
41
41
|
"""
|
|
42
|
-
The label (usually a [`Text`][flet.
|
|
42
|
+
The label (usually a [`Text`][flet.]) to be
|
|
43
43
|
displayed in the segment.
|
|
44
44
|
"""
|
|
45
45
|
|
|
@@ -147,7 +147,7 @@ class SegmentedButton(LayoutControl):
|
|
|
147
147
|
"""
|
|
148
148
|
Called when the selection changes.
|
|
149
149
|
|
|
150
|
-
The [`data`][flet.Event.
|
|
150
|
+
The [`data`][flet.Event.] property of the event handler argument
|
|
151
151
|
contains a list of strings identifying the selected segments.
|
|
152
152
|
"""
|
|
153
153
|
|
|
@@ -20,9 +20,10 @@ class SelectionArea(Control):
|
|
|
20
20
|
content: Control
|
|
21
21
|
"""
|
|
22
22
|
The child control this selection area applies to.
|
|
23
|
-
|
|
24
|
-
If you need to have multiple selectable controls, use container-like controls
|
|
25
|
-
like [`Row`][flet.
|
|
23
|
+
|
|
24
|
+
If you need to have multiple selectable controls, use container-like controls
|
|
25
|
+
like [`Row`][flet.] or [`Column`][flet.], which have a `controls` property
|
|
26
|
+
for this purpose.
|
|
26
27
|
"""
|
|
27
28
|
|
|
28
29
|
on_change: Optional[ControlEventHandler["SelectionArea"]] = None
|