Rename Icon.name to Icon.icon

FeodorFitsner · FeodorFitsner · commit d53230a03adb · 2025-08-14T15:25:31.000-07:00
diff --git a/packages/flet/lib/src/controls/icon.dart b/packages/flet/lib/src/controls/icon.dart
@@ -20,7 +20,7 @@ class IconControl extends StatelessWidget {
     return ConstrainedControl(
         control: control,
         child: Icon(
-          control.getIconData("name"),
+          control.getIconData("icon"),
           size: control.getDouble("size"),
           color: control.getColor("color", context),
           blendMode: control.getBlendMode("blend_mode"),
diff --git a/sdk/python/examples/apps/controls-gallery/components/controls_grid.py b/sdk/python/examples/apps/controls-gallery/components/controls_grid.py
@@ -32,7 +32,7 @@ def display(self, control_group):
                         alignment=ft.MainAxisAlignment.START,
                         vertical_alignment=ft.MainAxisAlignment.CENTER,
                         controls=[
-                            ft.Icon(name=ft.Icons.FOLDER_OPEN),
+                            ft.Icon(ft.Icons.FOLDER_OPEN),
                             ft.Text(
                                 value=grid_item.name,
                                 weight=ft.FontWeight.W_500,
diff --git a/sdk/python/examples/apps/controls-gallery/components/left_navigation_menu.py b/sdk/python/examples/apps/controls-gallery/components/left_navigation_menu.py
@@ -6,7 +6,7 @@ def __init__(self, color, name):
         super().__init__()
         self.content = ft.Row(
             controls=[
-                ft.Icon(name=ft.Icons.COLOR_LENS_OUTLINED, color=color),
+                ft.Icon(ft.Icons.COLOR_LENS_OUTLINED, color=color),
                 ft.Text(name),
             ],
         )
diff --git a/sdk/python/examples/apps/controls-gallery/examples/buttons/elevatedbutton/04_elevatedbuttons_with_custom_content.py b/sdk/python/examples/apps/controls-gallery/examples/buttons/elevatedbutton/04_elevatedbuttons_with_custom_content.py
@@ -10,9 +10,9 @@ def example():
                 width=150,
                 content=ft.Row(
                     [
-                        ft.Icon(name=ft.Icons.FAVORITE, color="pink"),
-                        ft.Icon(name=ft.Icons.AUDIOTRACK, color="green"),
-                        ft.Icon(name=ft.Icons.BEACH_ACCESS, color="blue"),
+                        ft.Icon(ft.Icons.FAVORITE, color="pink"),
+                        ft.Icon(ft.Icons.AUDIOTRACK, color="green"),
+                        ft.Icon(ft.Icons.BEACH_ACCESS, color="blue"),
                     ],
                     alignment=ft.MainAxisAlignment.SPACE_AROUND,
                 ),
diff --git a/sdk/python/examples/apps/controls-gallery/examples/buttons/outlinedbutton/04_outlinedbuttons_with_custom_content.py b/sdk/python/examples/apps/controls-gallery/examples/buttons/outlinedbutton/04_outlinedbuttons_with_custom_content.py
@@ -10,9 +10,9 @@ def example():
                 width=150,
                 content=ft.Row(
                     [
-                        ft.Icon(name=ft.Icons.FAVORITE, color="pink"),
-                        ft.Icon(name=ft.Icons.AUDIOTRACK, color="green"),
-                        ft.Icon(name=ft.Icons.BEACH_ACCESS, color="blue"),
+                        ft.Icon(ft.Icons.FAVORITE, color="pink"),
+                        ft.Icon(ft.Icons.AUDIOTRACK, color="green"),
+                        ft.Icon(ft.Icons.BEACH_ACCESS, color="blue"),
                     ],
                     alignment=ft.MainAxisAlignment.SPACE_AROUND,
                 ),
diff --git a/sdk/python/examples/apps/controls-gallery/examples/buttons/textbutton/04_textbuttons_with_custom_content.py b/sdk/python/examples/apps/controls-gallery/examples/buttons/textbutton/04_textbuttons_with_custom_content.py
@@ -10,9 +10,9 @@ def example():
                 width=150,
                 content=ft.Row(
                     [
-                        ft.Icon(name=ft.Icons.FAVORITE, color="pink"),
-                        ft.Icon(name=ft.Icons.AUDIOTRACK, color="green"),
-                        ft.Icon(name=ft.Icons.BEACH_ACCESS, color="blue"),
+                        ft.Icon(ft.Icons.FAVORITE, color="pink"),
+                        ft.Icon(ft.Icons.AUDIOTRACK, color="green"),
+                        ft.Icon(ft.Icons.BEACH_ACCESS, color="blue"),
                     ],
                     alignment=ft.MainAxisAlignment.SPACE_AROUND,
                 ),
diff --git a/sdk/python/examples/apps/controls-gallery/examples/displays/icon/01_icons_with_different_colors_and_sizes.py b/sdk/python/examples/apps/controls-gallery/examples/displays/icon/01_icons_with_different_colors_and_sizes.py
@@ -6,9 +6,9 @@
 def example():
     return ft.Row(
         [
-            ft.Icon(name=ft.Icons.FAVORITE, color=ft.Colors.PINK),
-            ft.Icon(name=ft.Icons.AUDIOTRACK, color=ft.Colors.GREEN_400, size=30),
-            ft.Icon(name=ft.Icons.BEACH_ACCESS, color=ft.Colors.BLUE, size=50),
-            ft.Icon(name="settings", color="#c1c1c1"),
+            ft.Icon(ft.Icons.FAVORITE, color=ft.Colors.PINK),
+            ft.Icon(ft.Icons.AUDIOTRACK, color=ft.Colors.GREEN_400, size=30),
+            ft.Icon(ft.Icons.BEACH_ACCESS, color=ft.Colors.BLUE, size=50),
+            ft.Icon(ft.Icons.SETTINGS, color="#c1c1c1"),
         ]
     )
diff --git a/sdk/python/examples/apps/controls-gallery/examples/layout/cupertinolisttile/01_cupertinolisttile_example.py b/sdk/python/examples/apps/controls-gallery/examples/layout/cupertinolisttile/01_cupertinolisttile_example.py
@@ -12,19 +12,19 @@ def tile_clicked(e):
             ft.CupertinoListTile(
                 additional_info=ft.Text("Wed Jan 24"),
                 bgcolor_activated=ft.Colors.AMBER_ACCENT,
-                leading=ft.Icon(name=ft.CupertinoIcons.GAME_CONTROLLER),
+                leading=ft.Icon(ft.CupertinoIcons.GAME_CONTROLLER),
                 title=ft.Text("CupertinoListTile not notched"),
                 subtitle=ft.Text("Subtitle"),
-                trailing=ft.Icon(name=ft.CupertinoIcons.ALARM),
+                trailing=ft.Icon(ft.CupertinoIcons.ALARM),
                 on_click=tile_clicked,
             ),
             ft.CupertinoListTile(
                 notched=True,
                 additional_info=ft.Text("Thu Jan 25"),
-                leading=ft.Icon(name=ft.CupertinoIcons.GAME_CONTROLLER),
+                leading=ft.Icon(ft.CupertinoIcons.GAME_CONTROLLER),
                 title=ft.Text("CupertinoListTile notched"),
                 subtitle=ft.Text("Subtitle"),
-                trailing=ft.Icon(name=ft.CupertinoIcons.ALARM),
+                trailing=ft.Icon(ft.CupertinoIcons.ALARM),
                 on_click=tile_clicked,
             ),
         ]
diff --git a/sdk/python/examples/controls/cupertino_button/basic.py b/sdk/python/examples/controls/cupertino_button/basic.py
@@ -28,12 +28,12 @@ def main(page: ft.Page):
             content=ft.Text("Disabled CupertinoButton"),
         ),
         ft.ElevatedButton(
-            adaptive=True,  # a CupertinoButton will be rendered when running on apple-platform
+            adaptive=True,
             bgcolor=ft.CupertinoColors.SYSTEM_TEAL,
             content=ft.Row(
                 tight=True,
                 controls=[
-                    ft.Icon(name=ft.Icons.FAVORITE, color="pink"),
+                    ft.Icon(ft.Icons.FAVORITE, color="pink"),
                     ft.Text("ElevatedButton+adaptive"),
                 ],
             ),
diff --git a/sdk/python/examples/controls/cupertino_list_tile/notched.py b/sdk/python/examples/controls/cupertino_list_tile/notched.py
@@ -9,19 +9,19 @@ def handle_tile_click(e: ft.Event[ft.CupertinoListTile]):
         ft.CupertinoListTile(
             additional_info=ft.Text("Wed Jan 24"),
             bgcolor_activated=ft.Colors.AMBER_ACCENT,
-            leading=ft.Icon(name=ft.CupertinoIcons.GAME_CONTROLLER),
+            leading=ft.Icon(ft.CupertinoIcons.GAME_CONTROLLER),
             title=ft.Text("CupertinoListTile: notched = False"),
             subtitle=ft.Text("Subtitle"),
-            trailing=ft.Icon(name=ft.CupertinoIcons.ALARM),
+            trailing=ft.Icon(ft.CupertinoIcons.ALARM),
             on_click=handle_tile_click,
         ),
         ft.CupertinoListTile(
             notched=True,
             additional_info=ft.Text("Thu Jan 25"),
-            leading=ft.Icon(name=ft.CupertinoIcons.GAME_CONTROLLER),
+            leading=ft.Icon(ft.CupertinoIcons.GAME_CONTROLLER),
             title=ft.Text("CupertinoListTile: notched = True"),
             subtitle=ft.Text("Subtitle"),
-            trailing=ft.Icon(name=ft.CupertinoIcons.ALARM),
+            trailing=ft.Icon(ft.CupertinoIcons.ALARM),
             on_click=handle_tile_click,
         ),
     )
diff --git a/sdk/python/examples/controls/drag_target_and_draggable/ordering.py b/sdk/python/examples/controls/drag_target_and_draggable/ordering.py
@@ -124,10 +124,10 @@ def remove_item(self, item):
     def handle_drag_accept(self, e: ft.DragTargetEvent):
         src = self.page.get_control(e.src_id)
 
-        l = self.list_row.current.controls
-        to_index = l.index(e.control.data)
-        from_index = l.index(src.content.data)
-        l[to_index], l[from_index] = l[from_index], l[to_index]
+        ctrls = self.list_row.current.controls
+        to_index = ctrls.index(e.control.data)
+        from_index = ctrls.index(src.content.data)
+        ctrls[to_index], ctrls[from_index] = ctrls[from_index], ctrls[to_index]
         self.end_indicator.opacity = 0.0
         self.page.update()
 
@@ -168,7 +168,7 @@ def __init__(self, list: ItemList, item_text: str):
                 content=ft.Row(
                     alignment=ft.MainAxisAlignment.START,
                     controls=[
-                        ft.Icon(name=ft.Icons.CIRCLE_OUTLINED),
+                        ft.Icon(ft.Icons.CIRCLE_OUTLINED),
                         ft.Text(value=f"{self.item_text}"),
                     ],
                 ),
diff --git a/sdk/python/examples/controls/elevated_button/custom_content.py b/sdk/python/examples/controls/elevated_button/custom_content.py
@@ -10,9 +10,9 @@ def main(page: ft.Page):
             content=ft.Row(
                 alignment=ft.MainAxisAlignment.SPACE_AROUND,
                 controls=[
-                    ft.Icon(name=ft.Icons.FAVORITE, color=ft.Colors.PINK),
-                    ft.Icon(name=ft.Icons.AUDIOTRACK, color=ft.Colors.GREEN),
-                    ft.Icon(name=ft.Icons.BEACH_ACCESS, color=ft.Colors.BLUE),
+                    ft.Icon(ft.Icons.FAVORITE, color=ft.Colors.PINK),
+                    ft.Icon(ft.Icons.AUDIOTRACK, color=ft.Colors.GREEN),
+                    ft.Icon(ft.Icons.BEACH_ACCESS, color=ft.Colors.BLUE),
                 ],
             ),
         ),
diff --git a/sdk/python/examples/controls/icon/basic.py b/sdk/python/examples/controls/icon/basic.py
@@ -8,28 +8,28 @@ def main(page: ft.Page):
         # material
         ft.Row(
             controls=[
-                ft.Icon(name=ft.Icons.FAVORITE, color=ft.Colors.PINK),
-                ft.Icon(name=ft.Icons.AUDIOTRACK, color=ft.Colors.GREEN_400, size=30),
-                ft.Icon(name=ft.Icons.BEACH_ACCESS, color=ft.Colors.BLUE, size=50),
-                ft.Icon(name=ft.Icons.SETTINGS, color="#c1c1c1"),
+                ft.Icon(ft.Icons.FAVORITE, color=ft.Colors.PINK),
+                ft.Icon(ft.Icons.AUDIOTRACK, color=ft.Colors.GREEN_400, size=30),
+                ft.Icon(ft.Icons.BEACH_ACCESS, color=ft.Colors.BLUE, size=50),
+                ft.Icon(ft.Icons.SETTINGS, color="#c1c1c1"),
             ]
         ),
         # cupertino
         ft.Row(
             controls=[
-                ft.Icon(name=ft.CupertinoIcons.AIRPLANE, color=ft.Colors.PINK),
+                ft.Icon(ft.CupertinoIcons.AIRPLANE, color=ft.Colors.PINK),
                 ft.Icon(
-                    name=cast(ft.CupertinoIcons, ft.CupertinoIcons.random()),
+                    icon=cast(ft.CupertinoIcons, ft.CupertinoIcons.random()),
                     color=ft.Colors.GREEN_400,
                     size=30,
                 ),
                 ft.Icon(
-                    name=cast(ft.CupertinoIcons, ft.CupertinoIcons.random()),
+                    icon=cast(ft.CupertinoIcons, ft.CupertinoIcons.random()),
                     color=ft.Colors.BLUE,
                     size=50,
                 ),
                 ft.Icon(
-                    name=cast(ft.CupertinoIcons, ft.CupertinoIcons.random()),
+                    icon=cast(ft.CupertinoIcons, ft.CupertinoIcons.random()),
                     color="#c1c1c1",
                 ),
             ]
diff --git a/sdk/python/examples/controls/outlined_button/custom_content.py b/sdk/python/examples/controls/outlined_button/custom_content.py
@@ -11,9 +11,9 @@ def main(page: ft.Page):
             content=ft.Row(
                 alignment=ft.MainAxisAlignment.SPACE_AROUND,
                 controls=[
-                    ft.Icon(name=ft.Icons.FAVORITE, color=ft.Colors.PINK),
-                    ft.Icon(name=ft.Icons.AUDIOTRACK, color=ft.Colors.GREEN),
-                    ft.Icon(name=ft.Icons.BEACH_ACCESS, color=ft.Colors.BLUE),
+                    ft.Icon(ft.Icons.FAVORITE, color=ft.Colors.PINK),
+                    ft.Icon(ft.Icons.AUDIOTRACK, color=ft.Colors.GREEN),
+                    ft.Icon(ft.Icons.BEACH_ACCESS, color=ft.Colors.BLUE),
                 ],
             ),
         ),
diff --git a/sdk/python/examples/controls/semantics/basic.py b/sdk/python/examples/controls/semantics/basic.py
@@ -21,7 +21,7 @@ def handle_lose_accessibility_focus(e: ft.Event[ft.Semantics]):
                         value="What is your occupation?",
                     ),
                 ),
-                ft.Icon(name="settings", color="#c1c1c1"),
+                ft.Icon(ft.Icons.SETTINGS, color="#c1c1c1"),
             ]
         )
     )
diff --git a/sdk/python/examples/controls/text_button/custom_content.py b/sdk/python/examples/controls/text_button/custom_content.py
@@ -10,9 +10,9 @@ def main(page: ft.Page):
             content=ft.Row(
                 alignment=ft.MainAxisAlignment.SPACE_AROUND,
                 controls=[
-                    ft.Icon(name=ft.Icons.FAVORITE, color=ft.Colors.PINK),
-                    ft.Icon(name=ft.Icons.AUDIOTRACK, color=ft.Colors.GREEN),
-                    ft.Icon(name=ft.Icons.BEACH_ACCESS, color=ft.Colors.BLUE),
+                    ft.Icon(ft.Icons.FAVORITE, color=ft.Colors.PINK),
+                    ft.Icon(ft.Icons.AUDIOTRACK, color=ft.Colors.GREEN),
+                    ft.Icon(ft.Icons.BEACH_ACCESS, color=ft.Colors.BLUE),
                 ],
             ),
         ),
diff --git a/sdk/python/packages/flet/src/flet/controls/core/icon.py b/sdk/python/packages/flet/src/flet/controls/core/icon.py
@@ -19,9 +19,9 @@ class Icon(ConstrainedControl):
         AssertionError: If [`optical_size`][(c).] is less than or equal to `0.0`.
     """
 
-    name: IconData
+    icon: IconData
     """
-    The name of the icon.
+    The icon to display.
 
     You can search through the list of all available icons using our
     [Icons browser](https://gallery.flet.dev/icons-browser/) app

Original file line number	Diff line number	Diff line change
`@@ -6,7 +6,7 @@ def __init__(self, color, name):`
`6`	`6`	`super().__init__()`
`7`	`7`	`self.content = ft.Row(`
`8`	`8`	`controls=[`
`9`		`- ft.Icon(name=ft.Icons.COLOR_LENS_OUTLINED, color=color),`
	`9`	`+ ft.Icon(ft.Icons.COLOR_LENS_OUTLINED, color=color),`
`10`	`10`	`ft.Text(name),`
`11`	`11`	`],`
`12`	`12`	`)`
Original file line number	Diff line number	Diff line change
`@@ -6,9 +6,9 @@`
`6`	`6`	`def example():`
`7`	`7`	`return ft.Row(`
`8`	`8`	`[`
`9`		`- ft.Icon(name=ft.Icons.FAVORITE, color=ft.Colors.PINK),`
`10`		`- ft.Icon(name=ft.Icons.AUDIOTRACK, color=ft.Colors.GREEN_400, size=30),`
`11`		`- ft.Icon(name=ft.Icons.BEACH_ACCESS, color=ft.Colors.BLUE, size=50),`
`12`		`- ft.Icon(name="settings", color="#c1c1c1"),`
	`9`	`+ ft.Icon(ft.Icons.FAVORITE, color=ft.Colors.PINK),`
	`10`	`+ ft.Icon(ft.Icons.AUDIOTRACK, color=ft.Colors.GREEN_400, size=30),`
	`11`	`+ ft.Icon(ft.Icons.BEACH_ACCESS, color=ft.Colors.BLUE, size=50),`
	`12`	`+ ft.Icon(ft.Icons.SETTINGS, color="#c1c1c1"),`
`13`	`13`	`]`
`14`	`14`	`)`