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.

Files changed (124) hide show
  1. flet/__init__.py +2 -0
  2. flet/controls/adaptive_control.py +16 -13
  3. flet/controls/base_page.py +5 -5
  4. flet/controls/border.py +4 -3
  5. flet/controls/box.py +6 -11
  6. flet/controls/buttons.py +7 -7
  7. flet/controls/context.py +2 -2
  8. flet/controls/control.py +18 -11
  9. flet/controls/core/animated_switcher.py +9 -13
  10. flet/controls/core/canvas/canvas.py +1 -1
  11. flet/controls/core/canvas/line.py +2 -3
  12. flet/controls/core/canvas/oval.py +1 -1
  13. flet/controls/core/canvas/shape.py +10 -10
  14. flet/controls/core/canvas/text.py +1 -1
  15. flet/controls/core/column.py +5 -5
  16. flet/controls/core/dismissible.py +8 -8
  17. flet/controls/core/drag_target.py +5 -4
  18. flet/controls/core/draggable.py +19 -14
  19. flet/controls/core/grid_view.py +2 -2
  20. flet/controls/core/image.py +1 -1
  21. flet/controls/core/interactive_viewer.py +2 -2
  22. flet/controls/core/list_view.py +7 -7
  23. flet/controls/core/markdown.py +1 -1
  24. flet/controls/core/pagelet.py +10 -10
  25. flet/controls/core/reorderable_draggable.py +1 -1
  26. flet/controls/core/responsive_row.py +7 -7
  27. flet/controls/core/row.py +8 -8
  28. flet/controls/core/semantics.py +9 -6
  29. flet/controls/core/shader_mask.py +3 -3
  30. flet/controls/core/stack.py +4 -4
  31. flet/controls/core/text.py +7 -7
  32. flet/controls/core/text_span.py +4 -4
  33. flet/controls/core/transparent_pointer.py +3 -3
  34. flet/controls/core/view.py +16 -16
  35. flet/controls/core/window.py +1 -1
  36. flet/controls/core/window_drag_area.py +1 -1
  37. flet/controls/cupertino/cupertino_action_sheet.py +19 -8
  38. flet/controls/cupertino/cupertino_activity_indicator.py +5 -6
  39. flet/controls/cupertino/cupertino_alert_dialog.py +7 -10
  40. flet/controls/cupertino/cupertino_app_bar.py +34 -34
  41. flet/controls/cupertino/cupertino_bottom_sheet.py +5 -5
  42. flet/controls/cupertino/cupertino_button.py +4 -4
  43. flet/controls/cupertino/cupertino_checkbox.py +33 -40
  44. flet/controls/cupertino/cupertino_context_menu.py +7 -6
  45. flet/controls/cupertino/cupertino_context_menu_action.py +2 -4
  46. flet/controls/cupertino/cupertino_date_picker.py +35 -37
  47. flet/controls/cupertino/cupertino_dialog_action.py +12 -9
  48. flet/controls/cupertino/cupertino_list_tile.py +24 -36
  49. flet/controls/cupertino/cupertino_navigation_bar.py +10 -11
  50. flet/controls/cupertino/cupertino_picker.py +11 -10
  51. flet/controls/cupertino/cupertino_radio.py +10 -13
  52. flet/controls/cupertino/cupertino_segmented_button.py +9 -12
  53. flet/controls/cupertino/cupertino_slider.py +6 -9
  54. flet/controls/cupertino/cupertino_sliding_segmented_button.py +14 -17
  55. flet/controls/cupertino/cupertino_switch.py +30 -41
  56. flet/controls/cupertino/cupertino_textfield.py +14 -18
  57. flet/controls/cupertino/cupertino_timer_picker.py +11 -8
  58. flet/controls/exceptions.py +5 -5
  59. flet/controls/icon_data.py +2 -2
  60. flet/controls/keys.py +2 -1
  61. flet/controls/layout_control.py +22 -27
  62. flet/controls/material/alert_dialog.py +44 -50
  63. flet/controls/material/app_bar.py +41 -45
  64. flet/controls/material/auto_complete.py +10 -8
  65. flet/controls/material/badge.py +32 -28
  66. flet/controls/material/banner.py +14 -14
  67. flet/controls/material/bottom_app_bar.py +7 -9
  68. flet/controls/material/bottom_sheet.py +10 -10
  69. flet/controls/material/button.py +2 -24
  70. flet/controls/material/card.py +10 -11
  71. flet/controls/material/checkbox.py +41 -49
  72. flet/controls/material/chip.py +44 -47
  73. flet/controls/material/circle_avatar.py +19 -22
  74. flet/controls/material/container.py +16 -123
  75. flet/controls/material/datatable.py +71 -95
  76. flet/controls/material/date_picker.py +13 -14
  77. flet/controls/material/date_range_picker.py +183 -0
  78. flet/controls/material/divider.py +24 -23
  79. flet/controls/material/dropdown.py +21 -13
  80. flet/controls/material/expansion_tile.py +5 -6
  81. flet/controls/material/filled_button.py +1 -1
  82. flet/controls/material/floating_action_button.py +2 -2
  83. flet/controls/material/form_field_control.py +64 -56
  84. flet/controls/material/icon_button.py +29 -65
  85. flet/controls/material/list_tile.py +41 -32
  86. flet/controls/material/menu_item_button.py +2 -2
  87. flet/controls/material/navigation_bar.py +3 -3
  88. flet/controls/material/navigation_rail.py +11 -11
  89. flet/controls/material/outlined_button.py +1 -1
  90. flet/controls/material/popup_menu_button.py +3 -3
  91. flet/controls/material/progress_bar.py +15 -22
  92. flet/controls/material/progress_ring.py +8 -8
  93. flet/controls/material/radio.py +3 -8
  94. flet/controls/material/range_slider.py +1 -1
  95. flet/controls/material/search_bar.py +15 -16
  96. flet/controls/material/segmented_button.py +4 -4
  97. flet/controls/material/selection_area.py +4 -3
  98. flet/controls/material/slider.py +16 -16
  99. flet/controls/material/snack_bar.py +33 -32
  100. flet/controls/material/submenu_button.py +9 -9
  101. flet/controls/material/switch.py +13 -13
  102. flet/controls/material/tabs.py +77 -78
  103. flet/controls/material/text_button.py +2 -2
  104. flet/controls/material/textfield.py +4 -6
  105. flet/controls/material/tooltip.py +16 -15
  106. flet/controls/material/vertical_divider.py +10 -10
  107. flet/controls/page.py +4 -4
  108. flet/controls/painting.py +2 -2
  109. flet/controls/scrollable_control.py +1 -1
  110. flet/controls/services/file_picker.py +7 -7
  111. flet/controls/services/haptic_feedback.py +1 -1
  112. flet/controls/services/shake_detector.py +1 -1
  113. flet/controls/services/storage_paths.py +3 -3
  114. flet/controls/text_style.py +1 -1
  115. flet/controls/theme.py +669 -608
  116. flet/controls/types.py +11 -11
  117. flet/testing/flet_test_app.py +4 -4
  118. flet/version.py +1 -1
  119. {flet-0.70.0.dev5620.dist-info → flet-0.70.0.dev5771.dist-info}/METADATA +5 -5
  120. flet-0.70.0.dev5771.dist-info/RECORD +239 -0
  121. flet-0.70.0.dev5620.dist-info/RECORD +0 -238
  122. {flet-0.70.0.dev5620.dist-info → flet-0.70.0.dev5771.dist-info}/WHEEL +0 -0
  123. {flet-0.70.0.dev5620.dist-info → flet-0.70.0.dev5771.dist-info}/entry_points.txt +0 -0
  124. {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.Text] control. This should not
49
- wrap. To enforce the single line limit, use [`Text.max_lines`][flet.Text.max_lines].
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`][flet.ListTile.is_three_line] is `False`, this should not wrap.
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.Text.max_lines] to enforce the
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.Text] control.
70
+ Typically a [`Text`][flet.] control.
63
71
  """
64
72
 
65
- is_three_line: bool = False
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.Text.max_lines].
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`][flet.ListTile.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`][flet.ListTile.title].
94
+ A control to display after the [`title`][(c).].
87
95
 
88
- Typically an [`Icon`][flet.Icon] control.
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
- bgcolor_activated: Optional[str] = None
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 = False
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.Radio],
137
- [`Checkbox`][flet.Checkbox] or [`Switch`][flet.Switch] inside this tile.
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 = True
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 = 16.0
175
+ horizontal_spacing: Optional[Number] = None
167
176
  """
168
177
  The horizontal gap between the `title` and the
169
- [`leading`][flet.ListTile.leading] and [`trailing`][flet.ListTile.trailing]
178
+ [`leading`][(c).] and [`trailing`][(c).]
170
179
  controls.
171
180
  """
172
181
 
173
- min_leading_width: Number = 40.0
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 = 4.0
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`][flet.ListTile.on_click] event callback is provided,
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`][flet.ListTile.leading] and
204
- [`trailing`][flet.ListTile.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`][flet.ListTile.title], [`subtitle`][flet.ListTile.subtitle],
211
- [`leading`][flet.ListTile.leading], and [`trailing`][flet.ListTile.trailing].
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.MouseCursor]
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.TextStyle] for the [`title`][flet.ListTile.title]
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.TextStyle] for the
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.TextStyle] for the
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`][flet.ListTile.dense] is `True`, these
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.Icon] control.
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.Icon] control.
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.NavigationBarDestination.label].
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.ControlState] states.
171
+ [`ControlState`][flet.] states.
172
172
 
173
- The following [`ControlState`][flet.ControlState]
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`][flet.NavigationRailDestination.indicator_shape] when
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.FloatingActionButton], but
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.TextStyle] of a
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.TextStyle] of a
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`][flet.NavigationRail.label_type]
227
- is [`NavigationRailLabelType.NONE`][flet.NavigationRailLabelType.NONE], or a
228
- [`StadiumBorder`][flet.StadiumBorder] if [`label_type`][flet.NavigationRail.label_type]
229
- is [`NavigationRailLabelType.ALL`][flet.NavigationRailLabelType.ALL] or
230
- [`NavigationRailLabelType.SELECTED`][flet.NavigationRailLabelType.SELECTED].
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.NavigationRailTheme.use_indicator].
234
- If that is also `None`, defaults to [`Theme.use_material3`][flet.Theme.use_material3].
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`][flet.OutlinedButton.on_click] event callback is
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`][flet.PopupMenuItem.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`][flet.PopupMenuItem.height] value of this menu item may
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`][flet.PopupMenuItem.content] is provided, then the padding's
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.year2023`][flet.ProgressBar.year_2023] is `True` or
68
- [`Theme.use_material3`][flet.Theme.use_material3] is `False`, then no stop
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
- [`ProgressIndicatorTheme.stop_indicator_color`][flet.ProgressIndicatorTheme.stop_indicator_color]
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.year2023`][flet.ProgressBar.year_2023] is `True` or
82
- [`Theme.use_material3`][flet.Theme.use_material3] is `False`, then no stop
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.year2023`][flet.ProgressBar.year_2023] is `True` or
97
- [`Theme.use_material3`][flet.Theme.use_material3] is `False`, then no track gap
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
- Set `track_gap` to `0` to hide the track gap.
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.Theme.use_material3] is `False`, then this property
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.ProgressRing.year_2023] is `True`, then the
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`][flet.ProgressRing.year_2023] is `True` or `Theme.use_material3` is
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.ProgressIndicatorTheme.track_gap] is used.
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.ProgressIndicatorTheme.size_constraints]
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.ProgressIndicatorTheme.circular_track_padding]
107
+ [`ProgressIndicatorTheme.circular_track_padding`][flet.]
108
108
  is used.
109
109
 
110
- If that's is also `None` and [`year_2023`][flet.ProgressRing.year_2023] is `False`,
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.ProgressIndicatorTheme.year_2023] will be
124
+ [`ProgressIndicatorTheme.year_2023`][flet.] will be
125
125
  used, which is `False` by default.
126
126
 
127
- If [`Theme.use_material3`][flet.Theme.use_material3] is `False`, then this property
127
+ If [`Theme.use_material3`][flet.] is `False`, then this property
128
128
  is ignored.
129
129
  """
@@ -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.ControlState] .
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.ListTile]s and will be displayed
34
- in a [`ListView`][flet.ListView].
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. Usually some text that suggests what sort of input the field
61
- accepts.
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
- search bar in all or specific
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
- typically used to indicate that the search bar is in `FOCUSED`, `HOVERED`, or
75
- `PRESSED` [`ControlState`][flet.ControlState]
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.SearchBar.bar_shape] to
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.SearchBar.bar_border_side] to create a shape
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.SearchBar.bar_hint_text].
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.TextStyle] of the
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.TextStyle] of
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.SegmentedButton].
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.Icon]) to be
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.Text]) to be
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.data] property of the event handler argument
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.Row] or [`Column`][flet.Column], which have a `controls` property for this purpose.
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