Theme

Customizes the overall appearance of the application.

Properties

• appbar_theme - Customizes the appearance of descendant AppBar controls.
• badge_theme - Customizes the appearance of descendant Badge controls.
• banner_theme - Customizes the appearance of descendant Banner controls.
• bottom_appbar_theme - Customizes the appearance of descendant BottomAppBar controls.
• bottom_sheet_theme - Customizes the appearance of descendant BottomSheet controls.
• button_theme - Customizes the appearance of descendant Button controls.
• canvas_color - The default color for canvas surfaces behind Material controls.
• card_bgcolor - The default background color for Card controls.
• card_theme - Customizes the appearance of descendant Card controls.
• checkbox_theme - Customizes the appearance of descendant Checkbox controls.
• chip_theme - Customizes the appearance of descendant Chip controls.
• color_scheme - Overrides the default ColorScheme used for the application.
• color_scheme_seed - Overrides the default color scheme seed used to generate ColorScheme.
• data_table_theme - Customizes the appearance of descendant DataTable controls.
• date_picker_theme - Customizes the appearance of descendant DatePicker controls.
• dialog_theme - Customizes the appearance of descendant AlertDialog controls.
• disabled_color - The color used for disabled controls and text.
• divider_color - Overrides the default color of dividers used in Divider, VerticalDivider, dividers between ListTiles, and dividers between rows in DataTable.
• divider_theme - Defines the visual properties of Divider, VerticalDivider, dividers between ListTiles, and dividers between rows in DataTable.
• dropdown_theme - Customizes the appearance of descendant Dropdown controls.
• expansion_tile_theme - Customizes the appearance of descendant ExpansionTile controls.
• filled_button_theme - Customizes the appearance of descendant FilledButton controls.
• floating_action_button_theme - Customizes the appearance of descendant FloatingActionButton controls.
• focus_color - The color used to indicate that a control has input focus.
• font_family - Overrides a default font for the app.
• highlight_color - The highlight color used during ink splash animations or to indicate a selected menu item.
• hint_color - The color used for hint or placeholder text, for example in TextField controls.
• hover_color - The color used to indicate that a pointer is hovering over a control.
• icon_button_theme - Customizes the appearance of descendant IconButton controls.
• icon_theme - Customizes the appearance of descendant Icon controls.
• list_tile_theme - Customizes the appearance of descendant ListTile controls.
• navigation_bar_theme - Customizes the appearance of descendant NavigationBar controls.
• navigation_drawer_theme - Customizes the appearance of descendant NavigationDrawer controls.
• navigation_rail_theme - Customizes the appearance of descendant NavigationRail controls.
• outlined_button_theme - Customizes the appearance of descendant OutlinedButton controls.
• page_transitions - Configures the default page transition presets used for route changes.
• popup_menu_theme - Customizes the appearance of descendant PopupMenuButton controls.
• primary_text_theme - A text theme that contrasts with the theme's primary color.
• progress_indicator_theme - Customizes the appearance of descendant ProgressBar and ProgressRing controls.
• radio_theme - Customizes the appearance of descendant Radio controls.
• scaffold_bgcolor - The default background color for scaffold-like page surfaces.
• scrollbar_theme - Customizes the appearance of descendant scrollbars.
• search_bar_theme - Customizes the appearance of descendant SearchBar controls.
• search_view_theme - Customizes the appearance of the search view presented by SearchBar.
• secondary_header_color - The color used for secondary headers, such as the header of a paginated data table when rows are selected.
• segmented_button_theme - Customizes the appearance of descendant SegmentedButton controls.
• slider_theme - Customizes the appearance of descendant Slider and RangeSlider controls.
• snackbar_theme - Customizes the appearance of descendant SnackBar controls.
• splash_color - The color of ink splashes.
• switch_theme - Customizes the appearance of descendant Switch controls.
• system_overlay_style - Customizes the appearance of the system status bar and navigation bar on mobile platforms.
• tab_bar_theme - Customizes the appearance of descendant TabBar controls.
• text_button_theme - Customizes the appearance of descendant TextButton controls.
• text_theme - The default text styles for descendant controls.
• time_picker_theme - Customizes the appearance of descendant TimePicker controls.
• tooltip_theme - Customizes the appearance of descendant tooltips.
• unselected_control_color - The color used for controls in their inactive but enabled state, such as an unchecked Checkbox.
• use_material3 - A temporary flag that can be used to opt-out of Material 3 features.
• visual_density - Specifies how compact descendant Material controls should be.

Properties

buildappbar_themeclass-attributeinstance-attribute

appbar_theme: AppBarTheme | None = None

Customizes the appearance of descendant AppBar controls.

buildbadge_themeclass-attributeinstance-attribute

badge_theme: BadgeTheme | None = None

Customizes the appearance of descendant Badge controls.

buildbanner_themeclass-attributeinstance-attribute

banner_theme: BannerTheme | None = None

Customizes the appearance of descendant Banner controls.

buildbottom_appbar_themeclass-attributeinstance-attribute

bottom_appbar_theme: BottomAppBarTheme | None = None

Customizes the appearance of descendant BottomAppBar controls.

buildbottom_sheet_themeclass-attributeinstance-attribute

bottom_sheet_theme: BottomSheetTheme | None = None

Customizes the appearance of descendant BottomSheet controls.

buildbutton_themeclass-attributeinstance-attribute

button_theme: ButtonTheme | None = None

Customizes the appearance of descendant Button controls.

buildcanvas_colorclass-attributeinstance-attribute

canvas_color: ColorValue | None = None

The default color for canvas surfaces behind Material controls.

buildcard_bgcolorclass-attributeinstance-attribute

card_bgcolor: ColorValue | None = None

The default background color for Card controls.

buildcard_themeclass-attributeinstance-attribute

card_theme: CardTheme | None = None

Customizes the appearance of descendant Card controls.

buildcheckbox_themeclass-attributeinstance-attribute

checkbox_theme: CheckboxTheme | None = None

Customizes the appearance of descendant Checkbox controls.

buildchip_themeclass-attributeinstance-attribute

chip_theme: ChipTheme | None = None

Customizes the appearance of descendant Chip controls.

buildcolor_schemeclass-attributeinstance-attribute

color_scheme: ColorScheme | None = None

Overrides the default ColorScheme used for the application.

buildcolor_scheme_seedclass-attributeinstance-attribute

color_scheme_seed: ColorValue | None = None

Overrides the default color scheme seed used to generate ColorScheme. The default color is blue.

builddata_table_themeclass-attributeinstance-attribute

data_table_theme: DataTableTheme | None = None

Customizes the appearance of descendant DataTable controls.

builddate_picker_themeclass-attributeinstance-attribute

date_picker_theme: DatePickerTheme | None = None

Customizes the appearance of descendant DatePicker controls.

builddialog_themeclass-attributeinstance-attribute

dialog_theme: DialogTheme | None = None

Customizes the appearance of descendant AlertDialog controls.

builddisabled_colorclass-attributeinstance-attribute

disabled_color: ColorValue | None = None

The color used for disabled controls and text.

builddivider_colorclass-attributeinstance-attribute

divider_color: ColorValue | None = None

Overrides the default color of dividers used in Divider, VerticalDivider, dividers between ListTiles, and dividers between rows in DataTable.

builddivider_themeclass-attributeinstance-attribute

divider_theme: DividerTheme | None = None

Defines the visual properties of Divider, VerticalDivider, dividers between ListTiles, and dividers between rows in DataTable.

builddropdown_themeclass-attributeinstance-attribute

dropdown_theme: DropdownTheme | None = None

Customizes the appearance of descendant Dropdown controls.

buildexpansion_tile_themeclass-attributeinstance-attribute

expansion_tile_theme: ExpansionTileTheme | None = None

Customizes the appearance of descendant ExpansionTile controls.

buildfilled_button_themeclass-attributeinstance-attribute

filled_button_theme: FilledButtonTheme | None = None

Customizes the appearance of descendant FilledButton controls.

buildfloating_action_button_themeclass-attributeinstance-attribute

floating_action_button_theme: (
    FloatingActionButtonTheme | None
) = None

Customizes the appearance of descendant FloatingActionButton controls.

buildfocus_colorclass-attributeinstance-attribute

focus_color: ColorValue | None = None

The color used to indicate that a control has input focus.

buildfont_familyclass-attributeinstance-attribute

font_family: str | None = None

Overrides a default font for the app.

buildhighlight_colorclass-attributeinstance-attribute

highlight_color: ColorValue | None = None

The highlight color used during ink splash animations or to indicate a selected menu item.

buildhint_colorclass-attributeinstance-attribute

hint_color: ColorValue | None = None

The color used for hint or placeholder text, for example in TextField controls.

buildhover_colorclass-attributeinstance-attribute

hover_color: ColorValue | None = None

The color used to indicate that a pointer is hovering over a control.

buildicon_button_themeclass-attributeinstance-attribute

icon_button_theme: IconButtonTheme | None = None

Customizes the appearance of descendant IconButton controls.

buildicon_themeclass-attributeinstance-attribute

icon_theme: IconTheme | None = None

Customizes the appearance of descendant Icon controls.

buildlist_tile_themeclass-attributeinstance-attribute

list_tile_theme: ListTileTheme | None = None

Customizes the appearance of descendant ListTile controls.

buildnavigation_bar_themeclass-attributeinstance-attribute

navigation_bar_theme: NavigationBarTheme | None = None

Customizes the appearance of descendant NavigationBar controls.

buildnavigation_drawer_themeclass-attributeinstance-attribute

navigation_drawer_theme: NavigationDrawerTheme | None = None

Customizes the appearance of descendant NavigationDrawer controls.

buildnavigation_rail_themeclass-attributeinstance-attribute

navigation_rail_theme: NavigationRailTheme | None = None

Customizes the appearance of descendant NavigationRail controls.

buildoutlined_button_themeclass-attributeinstance-attribute

outlined_button_theme: OutlinedButtonTheme | None = None

Customizes the appearance of descendant OutlinedButton controls.

buildpage_transitionsclass-attributeinstance-attribute

page_transitions: PageTransitionsTheme = field(
    default_factory=PageTransitionsTheme
)

Configures the default page transition presets used for route changes.

buildpopup_menu_themeclass-attributeinstance-attribute

popup_menu_theme: PopupMenuTheme | None = None

Customizes the appearance of descendant PopupMenuButton controls.

buildprimary_text_themeclass-attributeinstance-attribute

primary_text_theme: TextTheme | None = None

A text theme that contrasts with the theme's primary color.

buildprogress_indicator_themeclass-attributeinstance-attribute

progress_indicator_theme: ProgressIndicatorTheme | None = (
    None
)

Customizes the appearance of descendant ProgressBar and ProgressRing controls.

buildradio_themeclass-attributeinstance-attribute

radio_theme: RadioTheme | None = None

Customizes the appearance of descendant Radio controls.

buildscaffold_bgcolorclass-attributeinstance-attribute

scaffold_bgcolor: ColorValue | None = None

The default background color for scaffold-like page surfaces.

buildscrollbar_themeclass-attributeinstance-attribute

scrollbar_theme: ScrollbarTheme | None = None

Customizes the appearance of descendant scrollbars.

buildsearch_bar_themeclass-attributeinstance-attribute

search_bar_theme: SearchBarTheme | None = None

Customizes the appearance of descendant SearchBar controls.

buildsearch_view_themeclass-attributeinstance-attribute

search_view_theme: SearchViewTheme | None = None

Customizes the appearance of the search view presented by SearchBar.

buildsecondary_header_colorclass-attributeinstance-attribute

secondary_header_color: ColorValue | None = None

The color used for secondary headers, such as the header of a paginated data table when rows are selected.

buildsegmented_button_themeclass-attributeinstance-attribute

segmented_button_theme: SegmentedButtonTheme | None = None

Customizes the appearance of descendant SegmentedButton controls.

buildslider_themeclass-attributeinstance-attribute

slider_theme: SliderTheme | None = None

Customizes the appearance of descendant Slider and RangeSlider controls.

buildsnackbar_themeclass-attributeinstance-attribute

snackbar_theme: SnackBarTheme | None = None

Customizes the appearance of descendant SnackBar controls.

buildsplash_colorclass-attributeinstance-attribute

splash_color: ColorValue | None = None

The color of ink splashes.

buildswitch_themeclass-attributeinstance-attribute

switch_theme: SwitchTheme | None = None

Customizes the appearance of descendant Switch controls.

buildsystem_overlay_styleclass-attributeinstance-attribute

system_overlay_style: SystemOverlayStyle | None = None

Customizes the appearance of the system status bar and navigation bar on mobile platforms.

buildtab_bar_themeclass-attributeinstance-attribute

tab_bar_theme: TabBarTheme | None = None

Customizes the appearance of descendant TabBar controls.

buildtext_button_themeclass-attributeinstance-attribute

text_button_theme: TextButtonTheme | None = None

Customizes the appearance of descendant TextButton controls.

buildtext_themeclass-attributeinstance-attribute

text_theme: TextTheme | None = None

The default text styles for descendant controls.

buildtime_picker_themeclass-attributeinstance-attribute

time_picker_theme: TimePickerTheme | None = None

Customizes the appearance of descendant TimePicker controls.

buildtooltip_themeclass-attributeinstance-attribute

tooltip_theme: TooltipTheme | None = None

Customizes the appearance of descendant tooltips.

buildunselected_control_colorclass-attributeinstance-attribute

unselected_control_color: ColorValue | None = None

The color used for controls in their inactive but enabled state, such as an unchecked Checkbox.

builduse_material3class-attributeinstance-attribute

use_material3: bool | None = None

A temporary flag that can be used to opt-out of Material 3 features.

buildvisual_densityclass-attributeinstance-attribute

visual_density: VisualDensity | None = None

Specifies how compact descendant Material controls should be.

Negative density values make supported controls denser and more compact, while positive values make them more spacious. See VisualDensity.