9adbc51a80
Related to [☂️ Material Theme System Updates](https://github.com/flutter/flutter/issues/91772) ## Pre-launch Checklist - [x] I read the [Contributor Guide] and followed the process outlined there for submitting PRs. - [x] I read the [Tree Hygiene] wiki page, which explains my responsibilities. - [x] I read and followed the [Flutter Style Guide], including [Features we expect every widget to implement]. - [x] I signed the [CLA]. - [x] I listed at least one issue that this PR fixes in the description above. - [x] I updated/added relevant documentation (doc comments with `///`). - [x] I added new tests to check the change I am making, or this PR is [test-exempt]. - [x] I followed the [breaking change policy] and added [Data Driven Fixes] where supported. - [x] All existing and new tests are passing. If you need help, consider asking for advice on the #hackers-new channel on [Discord]. <!-- Links --> [Contributor Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview [Tree Hygiene]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md [test-exempt]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests [Flutter Style Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md [Features we expect every widget to implement]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement [CLA]: https://cla.developers.google.com/ [flutter/tests]: https://github.com/flutter/tests [breaking change policy]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes [Discord]: https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md [Data Driven Fixes]: https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md
3323 lines
128 KiB
Dart
3323 lines
128 KiB
Dart
// Copyright 2014 The Flutter Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style license that can be
|
|
// found in the LICENSE file.
|
|
|
|
/// @docImport 'package:flutter/material.dart';
|
|
library;
|
|
|
|
import 'dart:ui' show Color, lerpDouble;
|
|
|
|
import 'package:flutter/cupertino.dart';
|
|
import 'package:flutter/foundation.dart';
|
|
|
|
import 'action_buttons.dart';
|
|
import 'action_icons_theme.dart';
|
|
import 'app_bar_theme.dart';
|
|
import 'badge_theme.dart';
|
|
import 'banner_theme.dart';
|
|
import 'bottom_app_bar_theme.dart';
|
|
import 'bottom_navigation_bar_theme.dart';
|
|
import 'bottom_sheet_theme.dart';
|
|
import 'button_bar_theme.dart';
|
|
import 'button_theme.dart';
|
|
import 'card_theme.dart';
|
|
import 'checkbox_theme.dart';
|
|
import 'chip_theme.dart';
|
|
import 'color_scheme.dart';
|
|
import 'colors.dart';
|
|
import 'constants.dart';
|
|
import 'data_table_theme.dart';
|
|
import 'date_picker_theme.dart';
|
|
import 'dialog_theme.dart';
|
|
import 'divider_theme.dart';
|
|
import 'drawer_theme.dart';
|
|
import 'dropdown_menu_theme.dart';
|
|
import 'elevated_button_theme.dart';
|
|
import 'expansion_tile_theme.dart';
|
|
import 'filled_button_theme.dart';
|
|
import 'floating_action_button_theme.dart';
|
|
import 'icon_button_theme.dart';
|
|
import 'ink_ripple.dart';
|
|
import 'ink_sparkle.dart';
|
|
import 'ink_splash.dart';
|
|
import 'ink_well.dart' show InteractiveInkFeatureFactory;
|
|
import 'input_decorator.dart';
|
|
import 'list_tile.dart';
|
|
import 'list_tile_theme.dart';
|
|
import 'menu_bar_theme.dart';
|
|
import 'menu_button_theme.dart';
|
|
import 'menu_theme.dart';
|
|
import 'navigation_bar_theme.dart';
|
|
import 'navigation_drawer_theme.dart';
|
|
import 'navigation_rail_theme.dart';
|
|
import 'outlined_button_theme.dart';
|
|
import 'page_transitions_theme.dart';
|
|
import 'popup_menu_theme.dart';
|
|
import 'progress_indicator_theme.dart';
|
|
import 'radio_theme.dart';
|
|
import 'scrollbar_theme.dart';
|
|
import 'search_bar_theme.dart';
|
|
import 'search_view_theme.dart';
|
|
import 'segmented_button_theme.dart';
|
|
import 'slider_theme.dart';
|
|
import 'snack_bar_theme.dart';
|
|
import 'switch_theme.dart';
|
|
import 'tab_bar_theme.dart';
|
|
import 'text_button_theme.dart';
|
|
import 'text_selection_theme.dart';
|
|
import 'text_theme.dart';
|
|
import 'time_picker_theme.dart';
|
|
import 'toggle_buttons_theme.dart';
|
|
import 'tooltip_theme.dart';
|
|
import 'typography.dart';
|
|
|
|
export 'package:flutter/services.dart' show Brightness;
|
|
|
|
// Examples can assume:
|
|
// late BuildContext context;
|
|
|
|
/// Defines a customized theme for components with an `adaptive` factory constructor.
|
|
///
|
|
/// Currently, only [Switch.adaptive] supports this class.
|
|
class Adaptation<T> {
|
|
/// Creates an [Adaptation].
|
|
const Adaptation();
|
|
|
|
/// The adaptation's type.
|
|
Type get type => T;
|
|
|
|
/// Typically, this is overridden to return an instance of a custom component
|
|
/// ThemeData class, like [SwitchThemeData], instead of the defaultValue.
|
|
///
|
|
/// Factory constructors that support adaptations - currently only
|
|
/// [Switch.adaptive] - look for a type-specific adaptation in
|
|
/// [ThemeData.adaptationMap] when computing their effective default component
|
|
/// theme. If a matching adaptation is not found, the component may choose to
|
|
/// use a default adaptation. For example, the [Switch.adaptive] component
|
|
/// uses an empty [SwitchThemeData] if a matching adaptation is not found, for
|
|
/// the sake of backwards compatibility.
|
|
///
|
|
/// {@tool dartpad}
|
|
/// This sample shows how to create and use subclasses of [Adaptation] that
|
|
/// define adaptive [SwitchThemeData]s. The [adapt] method in this example is
|
|
/// overridden to only customize cupertino-style switches, but it can also be
|
|
/// used to customize any other platforms.
|
|
///
|
|
/// ** See code in examples/api/lib/material/switch/switch.4.dart **
|
|
/// {@end-tool}
|
|
T adapt(ThemeData theme, T defaultValue) => defaultValue;
|
|
}
|
|
|
|
/// An interface that defines custom additions to a [ThemeData] object.
|
|
///
|
|
/// {@youtube 560 315 https://www.youtube.com/watch?v=8-szcYzFVao}
|
|
///
|
|
/// Typically used for custom colors. To use, subclass [ThemeExtension],
|
|
/// define a number of fields (e.g. [Color]s), and implement the [copyWith] and
|
|
/// [lerp] methods. The latter will ensure smooth transitions of properties when
|
|
/// switching themes.
|
|
///
|
|
/// {@tool dartpad}
|
|
/// This sample shows how to create and use a subclass of [ThemeExtension] that
|
|
/// defines two colors.
|
|
///
|
|
/// ** See code in examples/api/lib/material/theme/theme_extension.1.dart **
|
|
/// {@end-tool}
|
|
abstract class ThemeExtension<T extends ThemeExtension<T>> {
|
|
/// Enable const constructor for subclasses.
|
|
const ThemeExtension();
|
|
|
|
/// The extension's type.
|
|
Object get type => T;
|
|
|
|
/// Creates a copy of this theme extension with the given fields
|
|
/// replaced by the non-null parameter values.
|
|
ThemeExtension<T> copyWith();
|
|
|
|
/// Linearly interpolate with another [ThemeExtension] object.
|
|
///
|
|
/// {@macro dart.ui.shadow.lerp}
|
|
ThemeExtension<T> lerp(covariant ThemeExtension<T>? other, double t);
|
|
}
|
|
|
|
/// Configures the tap target and layout size of certain Material widgets.
|
|
///
|
|
/// Changing the value in [ThemeData.materialTapTargetSize] will affect the
|
|
/// accessibility experience.
|
|
///
|
|
/// Some of the impacted widgets include:
|
|
///
|
|
/// * [FloatingActionButton], only the mini tap target size is increased.
|
|
/// * [MaterialButton]
|
|
/// * [OutlinedButton]
|
|
/// * [TextButton]
|
|
/// * [ElevatedButton]
|
|
/// * [IconButton]
|
|
/// * The time picker widget ([showTimePicker])
|
|
/// * [SnackBar]
|
|
/// * [Chip]
|
|
/// * [RawChip]
|
|
/// * [InputChip]
|
|
/// * [ChoiceChip]
|
|
/// * [FilterChip]
|
|
/// * [ActionChip]
|
|
/// * [Radio]
|
|
/// * [Switch]
|
|
/// * [Checkbox]
|
|
enum MaterialTapTargetSize {
|
|
/// Expands the minimum tap target size to 48px by 48px.
|
|
///
|
|
/// This is the default value of [ThemeData.materialTapTargetSize] and the
|
|
/// recommended size to conform to Android accessibility scanner
|
|
/// recommendations.
|
|
padded,
|
|
|
|
/// Shrinks the tap target size to the minimum provided by the Material
|
|
/// specification.
|
|
shrinkWrap,
|
|
}
|
|
|
|
/// Defines the configuration of the overall visual [Theme] for a [MaterialApp]
|
|
/// or a widget subtree within the app.
|
|
///
|
|
/// The [MaterialApp] theme property can be used to configure the appearance
|
|
/// of the entire app. Widget subtrees within an app can override the app's
|
|
/// theme by including a [Theme] widget at the top of the subtree.
|
|
///
|
|
/// Widgets whose appearance should align with the overall theme can obtain the
|
|
/// current theme's configuration with [Theme.of]. Material components typically
|
|
/// depend exclusively on the [colorScheme] and [textTheme]. These properties
|
|
/// are guaranteed to have non-null values.
|
|
///
|
|
/// The static [Theme.of] method finds the [ThemeData] value specified for the
|
|
/// nearest [BuildContext] ancestor. This lookup is inexpensive, essentially
|
|
/// just a single HashMap access. It can sometimes be a little confusing
|
|
/// because [Theme.of] can not see a [Theme] widget that is defined in the
|
|
/// current build method's context. To overcome that, create a new custom widget
|
|
/// for the subtree that appears below the new [Theme], or insert a widget
|
|
/// that creates a new BuildContext, like [Builder].
|
|
///
|
|
/// {@tool dartpad}
|
|
/// This example demonstrates how a typical [MaterialApp] specifies
|
|
/// and uses a custom [Theme]. The theme's [ColorScheme] is based on a
|
|
/// single "seed" color and configures itself to match the platform's
|
|
/// current light or dark color configuration. The theme overrides the
|
|
/// default configuration of [FloatingActionButton] to show how to
|
|
/// customize the appearance a class of components.
|
|
///
|
|
/// ** See code in examples/api/lib/material/theme_data/theme_data.0.dart **
|
|
/// {@end-tool}
|
|
///
|
|
/// See <https://material.io/design/color/> for
|
|
/// more discussion on how to pick the right colors.
|
|
|
|
@immutable
|
|
class ThemeData with Diagnosticable {
|
|
/// Create a [ThemeData] that's used to configure a [Theme].
|
|
///
|
|
/// The [colorScheme] and [textTheme] are used by the Material components to
|
|
/// compute default values for visual properties. The API documentation for
|
|
/// each component widget explains exactly how the defaults are computed.
|
|
///
|
|
/// When providing a [ColorScheme], apps can either provide one directly
|
|
/// with the [colorScheme] parameter, or have one generated for them by
|
|
/// using the [colorSchemeSeed] and [brightness] parameters. A generated
|
|
/// color scheme will be based on the tones of [colorSchemeSeed] and all of
|
|
/// its contrasting color will meet accessibility guidelines for readability.
|
|
/// (See [ColorScheme.fromSeed] for more details.)
|
|
///
|
|
/// If the app wants to customize a generated color scheme, it can use
|
|
/// [ColorScheme.fromSeed] directly and then [ColorScheme.copyWith] on the
|
|
/// result to override any colors that need to be replaced. The result of
|
|
/// this can be used as the [colorScheme] directly.
|
|
///
|
|
/// For historical reasons, instead of using a [colorSchemeSeed] or
|
|
/// [colorScheme], you can provide either a [primaryColor] or [primarySwatch]
|
|
/// to construct the [colorScheme], but the results will not be as complete
|
|
/// as when using generation from a seed color.
|
|
///
|
|
/// If [colorSchemeSeed] is non-null then [colorScheme], [primaryColor] and
|
|
/// [primarySwatch] must all be null.
|
|
///
|
|
/// The [textTheme] [TextStyle] colors are black if the color scheme's
|
|
/// brightness is [Brightness.light], and white for [Brightness.dark].
|
|
///
|
|
/// To override the appearance of specific components, provide
|
|
/// a component theme parameter like [sliderTheme], [toggleButtonsTheme],
|
|
/// or [bottomNavigationBarTheme].
|
|
///
|
|
/// See also:
|
|
///
|
|
/// * [ThemeData.from], which creates a ThemeData from a [ColorScheme].
|
|
/// * [ThemeData.light], which creates the default light theme.
|
|
/// * [ThemeData.dark], which creates the default dark theme.
|
|
/// * [ColorScheme.fromSeed], which is used to create a [ColorScheme] from a seed color.
|
|
factory ThemeData({
|
|
// For the sanity of the reader, make sure these properties are in the same
|
|
// order in every place that they are separated by section comments (e.g.
|
|
// GENERAL CONFIGURATION). Each section except for deprecations should be
|
|
// alphabetical by symbol name.
|
|
|
|
// GENERAL CONFIGURATION
|
|
Iterable<Adaptation<Object>>? adaptations,
|
|
bool? applyElevationOverlayColor,
|
|
NoDefaultCupertinoThemeData? cupertinoOverrideTheme,
|
|
Iterable<ThemeExtension<dynamic>>? extensions,
|
|
InputDecorationTheme? inputDecorationTheme,
|
|
MaterialTapTargetSize? materialTapTargetSize,
|
|
PageTransitionsTheme? pageTransitionsTheme,
|
|
TargetPlatform? platform,
|
|
ScrollbarThemeData? scrollbarTheme,
|
|
InteractiveInkFeatureFactory? splashFactory,
|
|
bool? useMaterial3,
|
|
VisualDensity? visualDensity,
|
|
// COLOR
|
|
ColorScheme? colorScheme,
|
|
Brightness? brightness,
|
|
Color? colorSchemeSeed,
|
|
// [colorScheme] is the preferred way to configure colors. The [Color] properties
|
|
// listed below (as well as primarySwatch) will gradually be phased out, see
|
|
// https://github.com/flutter/flutter/issues/91772.
|
|
Color? canvasColor,
|
|
Color? cardColor,
|
|
Color? disabledColor,
|
|
Color? dividerColor,
|
|
Color? focusColor,
|
|
Color? highlightColor,
|
|
Color? hintColor,
|
|
Color? hoverColor,
|
|
Color? primaryColor,
|
|
Color? primaryColorDark,
|
|
Color? primaryColorLight,
|
|
MaterialColor? primarySwatch,
|
|
Color? scaffoldBackgroundColor,
|
|
Color? secondaryHeaderColor,
|
|
Color? shadowColor,
|
|
Color? splashColor,
|
|
Color? unselectedWidgetColor,
|
|
// TYPOGRAPHY & ICONOGRAPHY
|
|
String? fontFamily,
|
|
List<String>? fontFamilyFallback,
|
|
String? package,
|
|
IconThemeData? iconTheme,
|
|
IconThemeData? primaryIconTheme,
|
|
TextTheme? primaryTextTheme,
|
|
TextTheme? textTheme,
|
|
Typography? typography,
|
|
// COMPONENT THEMES
|
|
ActionIconThemeData? actionIconTheme,
|
|
AppBarTheme? appBarTheme,
|
|
BadgeThemeData? badgeTheme,
|
|
MaterialBannerThemeData? bannerTheme,
|
|
BottomAppBarTheme? bottomAppBarTheme,
|
|
BottomNavigationBarThemeData? bottomNavigationBarTheme,
|
|
BottomSheetThemeData? bottomSheetTheme,
|
|
ButtonThemeData? buttonTheme,
|
|
// TODO(QuncCccccc): Change the parameter type to CardThemeData
|
|
Object? cardTheme,
|
|
CheckboxThemeData? checkboxTheme,
|
|
ChipThemeData? chipTheme,
|
|
DataTableThemeData? dataTableTheme,
|
|
DatePickerThemeData? datePickerTheme,
|
|
// TODO(QuncCccccc): Change the parameter type to DialogThemeData
|
|
Object? dialogTheme,
|
|
DividerThemeData? dividerTheme,
|
|
DrawerThemeData? drawerTheme,
|
|
DropdownMenuThemeData? dropdownMenuTheme,
|
|
ElevatedButtonThemeData? elevatedButtonTheme,
|
|
ExpansionTileThemeData? expansionTileTheme,
|
|
FilledButtonThemeData? filledButtonTheme,
|
|
FloatingActionButtonThemeData? floatingActionButtonTheme,
|
|
IconButtonThemeData? iconButtonTheme,
|
|
ListTileThemeData? listTileTheme,
|
|
MenuBarThemeData? menuBarTheme,
|
|
MenuButtonThemeData? menuButtonTheme,
|
|
MenuThemeData? menuTheme,
|
|
NavigationBarThemeData? navigationBarTheme,
|
|
NavigationDrawerThemeData? navigationDrawerTheme,
|
|
NavigationRailThemeData? navigationRailTheme,
|
|
OutlinedButtonThemeData? outlinedButtonTheme,
|
|
PopupMenuThemeData? popupMenuTheme,
|
|
ProgressIndicatorThemeData? progressIndicatorTheme,
|
|
RadioThemeData? radioTheme,
|
|
SearchBarThemeData? searchBarTheme,
|
|
SearchViewThemeData? searchViewTheme,
|
|
SegmentedButtonThemeData? segmentedButtonTheme,
|
|
SliderThemeData? sliderTheme,
|
|
SnackBarThemeData? snackBarTheme,
|
|
SwitchThemeData? switchTheme,
|
|
// TODO(QuncCccccc): Change the parameter type to TabBarThemeData
|
|
Object? tabBarTheme,
|
|
TextButtonThemeData? textButtonTheme,
|
|
TextSelectionThemeData? textSelectionTheme,
|
|
TimePickerThemeData? timePickerTheme,
|
|
ToggleButtonsThemeData? toggleButtonsTheme,
|
|
TooltipThemeData? tooltipTheme,
|
|
// DEPRECATED (newest deprecations at the bottom)
|
|
@Deprecated(
|
|
'Use OverflowBar instead. '
|
|
'This feature was deprecated after v3.21.0-10.0.pre.',
|
|
)
|
|
ButtonBarThemeData? buttonBarTheme,
|
|
@Deprecated(
|
|
'Use DialogThemeData.backgroundColor instead. '
|
|
'This feature was deprecated after v3.27.0-0.1.pre.',
|
|
)
|
|
Color? dialogBackgroundColor,
|
|
@Deprecated(
|
|
'Use TabBarThemeData.indicatorColor instead. '
|
|
'This feature was deprecated after v3.28.0-1.0.pre.',
|
|
)
|
|
Color? indicatorColor,
|
|
}) {
|
|
// GENERAL CONFIGURATION
|
|
cupertinoOverrideTheme = cupertinoOverrideTheme?.noDefault();
|
|
extensions ??= <ThemeExtension<dynamic>>[];
|
|
adaptations ??= <Adaptation<Object>>[];
|
|
inputDecorationTheme ??= const InputDecorationTheme();
|
|
platform ??= defaultTargetPlatform;
|
|
switch (platform) {
|
|
case TargetPlatform.android:
|
|
case TargetPlatform.fuchsia:
|
|
case TargetPlatform.iOS:
|
|
materialTapTargetSize ??= MaterialTapTargetSize.padded;
|
|
case TargetPlatform.linux:
|
|
case TargetPlatform.macOS:
|
|
case TargetPlatform.windows:
|
|
materialTapTargetSize ??= MaterialTapTargetSize.shrinkWrap;
|
|
}
|
|
pageTransitionsTheme ??= const PageTransitionsTheme();
|
|
scrollbarTheme ??= const ScrollbarThemeData();
|
|
visualDensity ??= VisualDensity.defaultDensityForPlatform(platform);
|
|
useMaterial3 ??= true;
|
|
final bool useInkSparkle = platform == TargetPlatform.android && !kIsWeb;
|
|
splashFactory ??=
|
|
useMaterial3
|
|
? useInkSparkle
|
|
? InkSparkle.splashFactory
|
|
: InkRipple.splashFactory
|
|
: InkSplash.splashFactory;
|
|
|
|
// COLOR
|
|
assert(
|
|
colorScheme?.brightness == null ||
|
|
brightness == null ||
|
|
colorScheme!.brightness == brightness,
|
|
'ThemeData.brightness does not match ColorScheme.brightness. '
|
|
'Either override ColorScheme.brightness or ThemeData.brightness to '
|
|
'match the other.',
|
|
);
|
|
assert(colorSchemeSeed == null || colorScheme == null);
|
|
assert(colorSchemeSeed == null || primarySwatch == null);
|
|
assert(colorSchemeSeed == null || primaryColor == null);
|
|
final Brightness effectiveBrightness =
|
|
brightness ?? colorScheme?.brightness ?? Brightness.light;
|
|
final bool isDark = effectiveBrightness == Brightness.dark;
|
|
if (colorSchemeSeed != null || useMaterial3) {
|
|
if (colorSchemeSeed != null) {
|
|
colorScheme = ColorScheme.fromSeed(
|
|
seedColor: colorSchemeSeed,
|
|
brightness: effectiveBrightness,
|
|
);
|
|
}
|
|
colorScheme ??= isDark ? _colorSchemeDarkM3 : _colorSchemeLightM3;
|
|
|
|
// For surfaces that use primary color in light themes and surface color in dark
|
|
final Color primarySurfaceColor = isDark ? colorScheme.surface : colorScheme.primary;
|
|
final Color onPrimarySurfaceColor = isDark ? colorScheme.onSurface : colorScheme.onPrimary;
|
|
|
|
// Default some of the color settings to values from the color scheme
|
|
primaryColor ??= primarySurfaceColor;
|
|
canvasColor ??= colorScheme.surface;
|
|
scaffoldBackgroundColor ??= colorScheme.surface;
|
|
cardColor ??= colorScheme.surface;
|
|
dividerColor ??= colorScheme.outline;
|
|
dialogBackgroundColor ??= colorScheme.surface;
|
|
indicatorColor ??= onPrimarySurfaceColor;
|
|
applyElevationOverlayColor ??= brightness == Brightness.dark;
|
|
}
|
|
applyElevationOverlayColor ??= false;
|
|
primarySwatch ??= Colors.blue;
|
|
primaryColor ??= isDark ? Colors.grey[900]! : primarySwatch;
|
|
final Brightness estimatedPrimaryColorBrightness = estimateBrightnessForColor(primaryColor);
|
|
primaryColorLight ??= isDark ? Colors.grey[500]! : primarySwatch[100]!;
|
|
primaryColorDark ??= isDark ? Colors.black : primarySwatch[700]!;
|
|
final bool primaryIsDark = estimatedPrimaryColorBrightness == Brightness.dark;
|
|
focusColor ??= isDark ? Colors.white.withOpacity(0.12) : Colors.black.withOpacity(0.12);
|
|
hoverColor ??= isDark ? Colors.white.withOpacity(0.04) : Colors.black.withOpacity(0.04);
|
|
shadowColor ??= Colors.black;
|
|
canvasColor ??= isDark ? Colors.grey[850]! : Colors.grey[50]!;
|
|
scaffoldBackgroundColor ??= canvasColor;
|
|
cardColor ??= isDark ? Colors.grey[800]! : Colors.white;
|
|
dividerColor ??= isDark ? const Color(0x1FFFFFFF) : const Color(0x1F000000);
|
|
// Create a ColorScheme that is backwards compatible as possible
|
|
// with the existing default ThemeData color values.
|
|
colorScheme ??= ColorScheme.fromSwatch(
|
|
primarySwatch: primarySwatch,
|
|
accentColor: isDark ? Colors.tealAccent[200]! : primarySwatch[500]!,
|
|
cardColor: cardColor,
|
|
backgroundColor: isDark ? Colors.grey[700]! : primarySwatch[200]!,
|
|
errorColor: Colors.red[700],
|
|
brightness: effectiveBrightness,
|
|
);
|
|
unselectedWidgetColor ??= isDark ? Colors.white70 : Colors.black54;
|
|
// Spec doesn't specify a dark theme secondaryHeaderColor, this is a guess.
|
|
secondaryHeaderColor ??= isDark ? Colors.grey[700]! : primarySwatch[50]!;
|
|
hintColor ??= isDark ? Colors.white60 : Colors.black.withOpacity(0.6);
|
|
// The default [buttonTheme] is here because it doesn't use the defaults for
|
|
// [disabledColor], [highlightColor], and [splashColor].
|
|
buttonTheme ??= ButtonThemeData(
|
|
colorScheme: colorScheme,
|
|
buttonColor: isDark ? primarySwatch[600]! : Colors.grey[300]!,
|
|
disabledColor: disabledColor,
|
|
focusColor: focusColor,
|
|
hoverColor: hoverColor,
|
|
highlightColor: highlightColor,
|
|
splashColor: splashColor,
|
|
materialTapTargetSize: materialTapTargetSize,
|
|
);
|
|
disabledColor ??= isDark ? Colors.white38 : Colors.black38;
|
|
highlightColor ??= isDark ? const Color(0x40CCCCCC) : const Color(0x66BCBCBC);
|
|
splashColor ??= isDark ? const Color(0x40CCCCCC) : const Color(0x66C8C8C8);
|
|
|
|
// TYPOGRAPHY & ICONOGRAPHY
|
|
typography ??=
|
|
useMaterial3
|
|
? Typography.material2021(platform: platform, colorScheme: colorScheme)
|
|
: Typography.material2014(platform: platform);
|
|
TextTheme defaultTextTheme = isDark ? typography.white : typography.black;
|
|
TextTheme defaultPrimaryTextTheme = primaryIsDark ? typography.white : typography.black;
|
|
if (fontFamily != null) {
|
|
defaultTextTheme = defaultTextTheme.apply(fontFamily: fontFamily);
|
|
defaultPrimaryTextTheme = defaultPrimaryTextTheme.apply(fontFamily: fontFamily);
|
|
}
|
|
if (fontFamilyFallback != null) {
|
|
defaultTextTheme = defaultTextTheme.apply(fontFamilyFallback: fontFamilyFallback);
|
|
defaultPrimaryTextTheme = defaultPrimaryTextTheme.apply(
|
|
fontFamilyFallback: fontFamilyFallback,
|
|
);
|
|
}
|
|
if (package != null) {
|
|
defaultTextTheme = defaultTextTheme.apply(package: package);
|
|
defaultPrimaryTextTheme = defaultPrimaryTextTheme.apply(package: package);
|
|
}
|
|
textTheme = defaultTextTheme.merge(textTheme);
|
|
primaryTextTheme = defaultPrimaryTextTheme.merge(primaryTextTheme);
|
|
iconTheme ??=
|
|
isDark
|
|
? IconThemeData(color: kDefaultIconLightColor)
|
|
: IconThemeData(color: kDefaultIconDarkColor);
|
|
primaryIconTheme ??=
|
|
primaryIsDark
|
|
? const IconThemeData(color: Colors.white)
|
|
: const IconThemeData(color: Colors.black);
|
|
|
|
// COMPONENT THEMES
|
|
appBarTheme ??= const AppBarTheme();
|
|
badgeTheme ??= const BadgeThemeData();
|
|
bannerTheme ??= const MaterialBannerThemeData();
|
|
bottomAppBarTheme ??= const BottomAppBarTheme();
|
|
bottomNavigationBarTheme ??= const BottomNavigationBarThemeData();
|
|
bottomSheetTheme ??= const BottomSheetThemeData();
|
|
// TODO(QuncCccccc): Clean it up once the type of `cardTheme` is changed to `CardThemeData`
|
|
if (cardTheme != null) {
|
|
if (cardTheme is CardTheme) {
|
|
cardTheme = cardTheme.data;
|
|
} else if (cardTheme is! CardThemeData) {
|
|
throw ArgumentError('cardTheme must be either a CardThemeData or a CardTheme');
|
|
}
|
|
}
|
|
cardTheme ??= const CardThemeData();
|
|
checkboxTheme ??= const CheckboxThemeData();
|
|
chipTheme ??= const ChipThemeData();
|
|
dataTableTheme ??= const DataTableThemeData();
|
|
datePickerTheme ??= const DatePickerThemeData();
|
|
// TODO(QuncCccccc): Clean this up once the type of `dialogTheme` is changed to `DialogThemeData`
|
|
if (dialogTheme != null) {
|
|
if (dialogTheme is DialogTheme) {
|
|
dialogTheme = dialogTheme.data;
|
|
} else if (dialogTheme is! DialogThemeData) {
|
|
throw ArgumentError('dialogTheme must be either a DialogThemeData or a DialogTheme');
|
|
}
|
|
}
|
|
dialogTheme ??= const DialogThemeData();
|
|
dividerTheme ??= const DividerThemeData();
|
|
drawerTheme ??= const DrawerThemeData();
|
|
dropdownMenuTheme ??= const DropdownMenuThemeData();
|
|
elevatedButtonTheme ??= const ElevatedButtonThemeData();
|
|
expansionTileTheme ??= const ExpansionTileThemeData();
|
|
filledButtonTheme ??= const FilledButtonThemeData();
|
|
floatingActionButtonTheme ??= const FloatingActionButtonThemeData();
|
|
iconButtonTheme ??= const IconButtonThemeData();
|
|
listTileTheme ??= const ListTileThemeData();
|
|
menuBarTheme ??= const MenuBarThemeData();
|
|
menuButtonTheme ??= const MenuButtonThemeData();
|
|
menuTheme ??= const MenuThemeData();
|
|
navigationBarTheme ??= const NavigationBarThemeData();
|
|
navigationDrawerTheme ??= const NavigationDrawerThemeData();
|
|
navigationRailTheme ??= const NavigationRailThemeData();
|
|
outlinedButtonTheme ??= const OutlinedButtonThemeData();
|
|
popupMenuTheme ??= const PopupMenuThemeData();
|
|
progressIndicatorTheme ??= const ProgressIndicatorThemeData();
|
|
radioTheme ??= const RadioThemeData();
|
|
searchBarTheme ??= const SearchBarThemeData();
|
|
searchViewTheme ??= const SearchViewThemeData();
|
|
segmentedButtonTheme ??= const SegmentedButtonThemeData();
|
|
sliderTheme ??= const SliderThemeData();
|
|
snackBarTheme ??= const SnackBarThemeData();
|
|
switchTheme ??= const SwitchThemeData();
|
|
// TODO(QuncCccccc): Clean this up once the type of `tabBarTheme` is changed to `TabBarThemeData`
|
|
if (tabBarTheme != null) {
|
|
if (tabBarTheme is TabBarTheme) {
|
|
tabBarTheme = tabBarTheme.data;
|
|
} else if (tabBarTheme is! TabBarThemeData) {
|
|
throw ArgumentError('tabBarTheme must be either a TabBarThemeData or a TabBarTheme');
|
|
}
|
|
}
|
|
tabBarTheme ??= const TabBarThemeData();
|
|
textButtonTheme ??= const TextButtonThemeData();
|
|
textSelectionTheme ??= const TextSelectionThemeData();
|
|
timePickerTheme ??= const TimePickerThemeData();
|
|
toggleButtonsTheme ??= const ToggleButtonsThemeData();
|
|
tooltipTheme ??= const TooltipThemeData();
|
|
// DEPRECATED (newest deprecations at the bottom)
|
|
buttonBarTheme ??= const ButtonBarThemeData();
|
|
dialogBackgroundColor ??= isDark ? Colors.grey[800]! : Colors.white;
|
|
indicatorColor ??= colorScheme.secondary == primaryColor ? Colors.white : colorScheme.secondary;
|
|
return ThemeData.raw(
|
|
// For the sanity of the reader, make sure these properties are in the same
|
|
// order in every place that they are separated by section comments (e.g.
|
|
// GENERAL CONFIGURATION). Each section except for deprecations should be
|
|
// alphabetical by symbol name.
|
|
|
|
// GENERAL CONFIGURATION
|
|
adaptationMap: _createAdaptationMap(adaptations),
|
|
applyElevationOverlayColor: applyElevationOverlayColor,
|
|
cupertinoOverrideTheme: cupertinoOverrideTheme,
|
|
extensions: _themeExtensionIterableToMap(extensions),
|
|
inputDecorationTheme: inputDecorationTheme,
|
|
materialTapTargetSize: materialTapTargetSize,
|
|
pageTransitionsTheme: pageTransitionsTheme,
|
|
platform: platform,
|
|
scrollbarTheme: scrollbarTheme,
|
|
splashFactory: splashFactory,
|
|
useMaterial3: useMaterial3,
|
|
visualDensity: visualDensity,
|
|
// COLOR
|
|
canvasColor: canvasColor,
|
|
cardColor: cardColor,
|
|
colorScheme: colorScheme,
|
|
disabledColor: disabledColor,
|
|
dividerColor: dividerColor,
|
|
focusColor: focusColor,
|
|
highlightColor: highlightColor,
|
|
hintColor: hintColor,
|
|
hoverColor: hoverColor,
|
|
primaryColor: primaryColor,
|
|
primaryColorDark: primaryColorDark,
|
|
primaryColorLight: primaryColorLight,
|
|
scaffoldBackgroundColor: scaffoldBackgroundColor,
|
|
secondaryHeaderColor: secondaryHeaderColor,
|
|
shadowColor: shadowColor,
|
|
splashColor: splashColor,
|
|
unselectedWidgetColor: unselectedWidgetColor,
|
|
// TYPOGRAPHY & ICONOGRAPHY
|
|
iconTheme: iconTheme,
|
|
primaryTextTheme: primaryTextTheme,
|
|
textTheme: textTheme,
|
|
typography: typography,
|
|
primaryIconTheme: primaryIconTheme,
|
|
// COMPONENT THEMES
|
|
actionIconTheme: actionIconTheme,
|
|
appBarTheme: appBarTheme,
|
|
badgeTheme: badgeTheme,
|
|
bannerTheme: bannerTheme,
|
|
bottomAppBarTheme: bottomAppBarTheme,
|
|
bottomNavigationBarTheme: bottomNavigationBarTheme,
|
|
bottomSheetTheme: bottomSheetTheme,
|
|
buttonTheme: buttonTheme,
|
|
cardTheme: cardTheme as CardThemeData,
|
|
checkboxTheme: checkboxTheme,
|
|
chipTheme: chipTheme,
|
|
dataTableTheme: dataTableTheme,
|
|
datePickerTheme: datePickerTheme,
|
|
dialogTheme: dialogTheme as DialogThemeData,
|
|
dividerTheme: dividerTheme,
|
|
drawerTheme: drawerTheme,
|
|
dropdownMenuTheme: dropdownMenuTheme,
|
|
elevatedButtonTheme: elevatedButtonTheme,
|
|
expansionTileTheme: expansionTileTheme,
|
|
filledButtonTheme: filledButtonTheme,
|
|
floatingActionButtonTheme: floatingActionButtonTheme,
|
|
iconButtonTheme: iconButtonTheme,
|
|
listTileTheme: listTileTheme,
|
|
menuBarTheme: menuBarTheme,
|
|
menuButtonTheme: menuButtonTheme,
|
|
menuTheme: menuTheme,
|
|
navigationBarTheme: navigationBarTheme,
|
|
navigationDrawerTheme: navigationDrawerTheme,
|
|
navigationRailTheme: navigationRailTheme,
|
|
outlinedButtonTheme: outlinedButtonTheme,
|
|
popupMenuTheme: popupMenuTheme,
|
|
progressIndicatorTheme: progressIndicatorTheme,
|
|
radioTheme: radioTheme,
|
|
searchBarTheme: searchBarTheme,
|
|
searchViewTheme: searchViewTheme,
|
|
segmentedButtonTheme: segmentedButtonTheme,
|
|
sliderTheme: sliderTheme,
|
|
snackBarTheme: snackBarTheme,
|
|
switchTheme: switchTheme,
|
|
tabBarTheme: tabBarTheme as TabBarThemeData,
|
|
textButtonTheme: textButtonTheme,
|
|
textSelectionTheme: textSelectionTheme,
|
|
timePickerTheme: timePickerTheme,
|
|
toggleButtonsTheme: toggleButtonsTheme,
|
|
tooltipTheme: tooltipTheme,
|
|
// DEPRECATED (newest deprecations at the bottom)
|
|
buttonBarTheme: buttonBarTheme,
|
|
dialogBackgroundColor: dialogBackgroundColor,
|
|
indicatorColor: indicatorColor,
|
|
);
|
|
}
|
|
|
|
/// Create a [ThemeData] given a set of exact values. Most values must be
|
|
/// specified. They all must also be non-null except for
|
|
/// [cupertinoOverrideTheme], and deprecated members.
|
|
///
|
|
/// This will rarely be used directly. It is used by [lerp] to
|
|
/// create intermediate themes based on two themes created with the
|
|
/// [ThemeData] constructor.
|
|
const ThemeData.raw({
|
|
// For the sanity of the reader, make sure these properties are in the same
|
|
// order in every place that they are separated by section comments (e.g.
|
|
// GENERAL CONFIGURATION). Each section except for deprecations should be
|
|
// alphabetical by symbol name.
|
|
|
|
// GENERAL CONFIGURATION
|
|
required this.adaptationMap,
|
|
required this.applyElevationOverlayColor,
|
|
required this.cupertinoOverrideTheme,
|
|
required this.extensions,
|
|
required this.inputDecorationTheme,
|
|
required this.materialTapTargetSize,
|
|
required this.pageTransitionsTheme,
|
|
required this.platform,
|
|
required this.scrollbarTheme,
|
|
required this.splashFactory,
|
|
required this.useMaterial3,
|
|
required this.visualDensity,
|
|
// COLOR
|
|
required this.colorScheme,
|
|
// [colorScheme] is the preferred way to configure colors. The [Color] properties
|
|
// listed below (as well as primarySwatch) will gradually be phased out, see
|
|
// https://github.com/flutter/flutter/issues/91772.
|
|
required this.canvasColor,
|
|
required this.cardColor,
|
|
required this.disabledColor,
|
|
required this.dividerColor,
|
|
required this.focusColor,
|
|
required this.highlightColor,
|
|
required this.hintColor,
|
|
required this.hoverColor,
|
|
required this.primaryColor,
|
|
required this.primaryColorDark,
|
|
required this.primaryColorLight,
|
|
required this.scaffoldBackgroundColor,
|
|
required this.secondaryHeaderColor,
|
|
required this.shadowColor,
|
|
required this.splashColor,
|
|
required this.unselectedWidgetColor,
|
|
// TYPOGRAPHY & ICONOGRAPHY
|
|
required this.iconTheme,
|
|
required this.primaryIconTheme,
|
|
required this.primaryTextTheme,
|
|
required this.textTheme,
|
|
required this.typography,
|
|
// COMPONENT THEMES
|
|
required this.actionIconTheme,
|
|
required this.appBarTheme,
|
|
required this.badgeTheme,
|
|
required this.bannerTheme,
|
|
required this.bottomAppBarTheme,
|
|
required this.bottomNavigationBarTheme,
|
|
required this.bottomSheetTheme,
|
|
required this.buttonTheme,
|
|
required this.cardTheme,
|
|
required this.checkboxTheme,
|
|
required this.chipTheme,
|
|
required this.dataTableTheme,
|
|
required this.datePickerTheme,
|
|
required this.dialogTheme,
|
|
required this.dividerTheme,
|
|
required this.drawerTheme,
|
|
required this.dropdownMenuTheme,
|
|
required this.elevatedButtonTheme,
|
|
required this.expansionTileTheme,
|
|
required this.filledButtonTheme,
|
|
required this.floatingActionButtonTheme,
|
|
required this.iconButtonTheme,
|
|
required this.listTileTheme,
|
|
required this.menuBarTheme,
|
|
required this.menuButtonTheme,
|
|
required this.menuTheme,
|
|
required this.navigationBarTheme,
|
|
required this.navigationDrawerTheme,
|
|
required this.navigationRailTheme,
|
|
required this.outlinedButtonTheme,
|
|
required this.popupMenuTheme,
|
|
required this.progressIndicatorTheme,
|
|
required this.radioTheme,
|
|
required this.searchBarTheme,
|
|
required this.searchViewTheme,
|
|
required this.segmentedButtonTheme,
|
|
required this.sliderTheme,
|
|
required this.snackBarTheme,
|
|
required this.switchTheme,
|
|
required this.tabBarTheme,
|
|
required this.textButtonTheme,
|
|
required this.textSelectionTheme,
|
|
required this.timePickerTheme,
|
|
required this.toggleButtonsTheme,
|
|
required this.tooltipTheme,
|
|
// DEPRECATED (newest deprecations at the bottom)
|
|
@Deprecated(
|
|
'Use OverflowBar instead. '
|
|
'This feature was deprecated after v3.21.0-10.0.pre.',
|
|
)
|
|
ButtonBarThemeData? buttonBarTheme,
|
|
@Deprecated(
|
|
'Use DialogThemeData.backgroundColor instead. '
|
|
'This feature was deprecated after v3.27.0-0.1.pre.',
|
|
)
|
|
required this.dialogBackgroundColor,
|
|
@Deprecated(
|
|
'Use TabBarThemeData.indicatorColor instead. '
|
|
'This feature was deprecated after v3.28.0-1.0.pre.',
|
|
)
|
|
required this.indicatorColor,
|
|
}) : // DEPRECATED (newest deprecations at the bottom)
|
|
// should not be `required`, use getter pattern to avoid breakages.
|
|
_buttonBarTheme = buttonBarTheme,
|
|
assert(buttonBarTheme != null);
|
|
|
|
/// Create a [ThemeData] based on the colors in the given [colorScheme] and
|
|
/// text styles of the optional [textTheme].
|
|
///
|
|
/// If [colorScheme].brightness is [Brightness.dark] then
|
|
/// [ThemeData.applyElevationOverlayColor] will be set to true to support
|
|
/// the Material dark theme method for indicating elevation by applying
|
|
/// a semi-transparent onSurface color on top of the surface color.
|
|
///
|
|
/// This is the recommended method to theme your application. As we move
|
|
/// forward we will be converting all the widget implementations to only use
|
|
/// colors or colors derived from those in [ColorScheme].
|
|
///
|
|
/// {@tool snippet}
|
|
/// This example will set up an application to use the baseline Material
|
|
/// Design light and dark themes.
|
|
///
|
|
/// ```dart
|
|
/// MaterialApp(
|
|
/// theme: ThemeData.from(colorScheme: const ColorScheme.light()),
|
|
/// darkTheme: ThemeData.from(colorScheme: const ColorScheme.dark()),
|
|
/// )
|
|
/// ```
|
|
/// {@end-tool}
|
|
///
|
|
/// See <https://material.io/design/color/> for
|
|
/// more discussion on how to pick the right colors.
|
|
factory ThemeData.from({
|
|
required ColorScheme colorScheme,
|
|
TextTheme? textTheme,
|
|
bool? useMaterial3,
|
|
}) {
|
|
final bool isDark = colorScheme.brightness == Brightness.dark;
|
|
|
|
// For surfaces that use primary color in light themes and surface color in dark
|
|
final Color primarySurfaceColor = isDark ? colorScheme.surface : colorScheme.primary;
|
|
final Color onPrimarySurfaceColor = isDark ? colorScheme.onSurface : colorScheme.onPrimary;
|
|
|
|
return ThemeData(
|
|
colorScheme: colorScheme,
|
|
brightness: colorScheme.brightness,
|
|
primaryColor: primarySurfaceColor,
|
|
canvasColor: colorScheme.surface,
|
|
scaffoldBackgroundColor: colorScheme.surface,
|
|
cardColor: colorScheme.surface,
|
|
dividerColor: colorScheme.onSurface.withOpacity(0.12),
|
|
dialogBackgroundColor: colorScheme.surface,
|
|
indicatorColor: onPrimarySurfaceColor,
|
|
textTheme: textTheme,
|
|
applyElevationOverlayColor: isDark,
|
|
useMaterial3: useMaterial3,
|
|
);
|
|
}
|
|
|
|
/// A default light theme.
|
|
///
|
|
/// This theme does not contain text geometry. Instead, it is expected that
|
|
/// this theme is localized using text geometry using [ThemeData.localize].
|
|
factory ThemeData.light({bool? useMaterial3}) =>
|
|
ThemeData(brightness: Brightness.light, useMaterial3: useMaterial3);
|
|
|
|
/// A default dark theme.
|
|
///
|
|
/// This theme does not contain text geometry. Instead, it is expected that
|
|
/// this theme is localized using text geometry using [ThemeData.localize].
|
|
factory ThemeData.dark({bool? useMaterial3}) =>
|
|
ThemeData(brightness: Brightness.dark, useMaterial3: useMaterial3);
|
|
|
|
/// The default color theme. Same as [ThemeData.light].
|
|
///
|
|
/// This is used by [Theme.of] when no theme has been specified.
|
|
///
|
|
/// This theme does not contain text geometry. Instead, it is expected that
|
|
/// this theme is localized using text geometry using [ThemeData.localize].
|
|
///
|
|
/// Most applications would use [Theme.of], which provides correct localized
|
|
/// text geometry.
|
|
factory ThemeData.fallback({bool? useMaterial3}) => ThemeData.light(useMaterial3: useMaterial3);
|
|
|
|
/// Used to obtain a particular [Adaptation] from [adaptationMap].
|
|
///
|
|
/// To get an adaptation, use `Theme.of(context).getAdaptation<MyAdaptation>()`.
|
|
Adaptation<T>? getAdaptation<T>() => adaptationMap[T] as Adaptation<T>?;
|
|
|
|
static Map<Type, Adaptation<Object>> _createAdaptationMap(
|
|
Iterable<Adaptation<Object>> adaptations,
|
|
) {
|
|
final Map<Type, Adaptation<Object>> adaptationMap = <Type, Adaptation<Object>>{
|
|
for (final Adaptation<Object> adaptation in adaptations) adaptation.type: adaptation,
|
|
};
|
|
return adaptationMap;
|
|
}
|
|
|
|
/// The overall theme brightness.
|
|
///
|
|
/// The default [TextStyle] color for the [textTheme] is black if the
|
|
/// theme is constructed with [Brightness.light] and white if the
|
|
/// theme is constructed with [Brightness.dark].
|
|
Brightness get brightness => colorScheme.brightness;
|
|
|
|
// For the sanity of the reader, make sure these properties are in the same
|
|
// order in every place that they are separated by section comments (e.g.
|
|
// GENERAL CONFIGURATION). Each section except for deprecations should be
|
|
// alphabetical by symbol name.
|
|
|
|
// GENERAL CONFIGURATION
|
|
|
|
/// Apply a semi-transparent overlay color on Material surfaces to indicate
|
|
/// elevation for dark themes.
|
|
///
|
|
/// If [useMaterial3] is true, then this flag is ignored as there is a new
|
|
/// [Material.surfaceTintColor] used to create an overlay for Material 3.
|
|
/// This flag is meant only for the Material 2 elevation overlay for dark
|
|
/// themes.
|
|
///
|
|
/// Material drop shadows can be difficult to see in a dark theme, so the
|
|
/// elevation of a surface should be portrayed with an "overlay" in addition
|
|
/// to the shadow. As the elevation of the component increases, the
|
|
/// overlay increases in opacity. [applyElevationOverlayColor] turns the
|
|
/// application of this overlay on or off for dark themes.
|
|
///
|
|
/// If true and [brightness] is [Brightness.dark], a
|
|
/// semi-transparent version of [ColorScheme.onSurface] will be
|
|
/// applied on top of [Material] widgets that have a [ColorScheme.surface]
|
|
/// color. The level of transparency is based on [Material.elevation] as
|
|
/// per the Material Dark theme specification.
|
|
///
|
|
/// If false the surface color will be used unmodified.
|
|
///
|
|
/// Defaults to false in order to maintain backwards compatibility with
|
|
/// apps that were built before the Material Dark theme specification
|
|
/// was published. New apps should set this to true for any themes
|
|
/// where [brightness] is [Brightness.dark].
|
|
///
|
|
/// See also:
|
|
///
|
|
/// * [Material.elevation], which effects the level of transparency of the
|
|
/// overlay color.
|
|
/// * [ElevationOverlay.applyOverlay], which is used by [Material] to apply
|
|
/// the overlay color to its surface color.
|
|
/// * <https://material.io/design/color/dark-theme.html>, which specifies how
|
|
/// the overlay should be applied.
|
|
final bool applyElevationOverlayColor;
|
|
|
|
/// Components of the [CupertinoThemeData] to override from the Material
|
|
/// [ThemeData] adaptation.
|
|
///
|
|
/// By default, [cupertinoOverrideTheme] is null and Cupertino widgets
|
|
/// descendant to the Material [Theme] will adhere to a [CupertinoTheme]
|
|
/// derived from the Material [ThemeData]. e.g. [ThemeData]'s [ColorScheme]
|
|
/// will also inform the [CupertinoThemeData]'s `primaryColor` etc.
|
|
///
|
|
/// This cascading effect for individual attributes of the [CupertinoThemeData]
|
|
/// can be overridden using attributes of this [cupertinoOverrideTheme].
|
|
final NoDefaultCupertinoThemeData? cupertinoOverrideTheme;
|
|
|
|
/// Arbitrary additions to this theme.
|
|
///
|
|
/// To define extensions, pass an [Iterable] containing one or more [ThemeExtension]
|
|
/// subclasses to [ThemeData.new] or [copyWith].
|
|
///
|
|
/// To obtain an extension, use [extension].
|
|
///
|
|
/// {@tool dartpad}
|
|
/// This sample shows how to create and use a subclass of [ThemeExtension] that
|
|
/// defines two colors.
|
|
///
|
|
/// ** See code in examples/api/lib/material/theme/theme_extension.1.dart **
|
|
/// {@end-tool}
|
|
///
|
|
/// See also:
|
|
///
|
|
/// * [extension], a convenience function for obtaining a specific extension.
|
|
final Map<Object, ThemeExtension<dynamic>> extensions;
|
|
|
|
/// Used to obtain a particular [ThemeExtension] from [extensions].
|
|
///
|
|
/// Obtain with `Theme.of(context).extension<MyThemeExtension>()`.
|
|
///
|
|
/// See [extensions] for an interactive example.
|
|
T? extension<T>() => extensions[T] as T?;
|
|
|
|
/// A map which contains the adaptations for the theme. The entry's key is the
|
|
/// type of the adaptation; the value is the adaptation itself.
|
|
///
|
|
/// To obtain an adaptation, use [getAdaptation].
|
|
final Map<Type, Adaptation<Object>> adaptationMap;
|
|
|
|
/// The default [InputDecoration] values for [InputDecorator], [TextField],
|
|
/// and [TextFormField] are based on this theme.
|
|
///
|
|
/// See [InputDecoration.applyDefaults].
|
|
final InputDecorationTheme inputDecorationTheme;
|
|
|
|
/// Configures the hit test size of certain Material widgets.
|
|
///
|
|
/// Defaults to a [platform]-appropriate size: [MaterialTapTargetSize.padded]
|
|
/// on mobile platforms, [MaterialTapTargetSize.shrinkWrap] on desktop
|
|
/// platforms.
|
|
final MaterialTapTargetSize materialTapTargetSize;
|
|
|
|
/// Default [MaterialPageRoute] transitions per [TargetPlatform].
|
|
///
|
|
/// [MaterialPageRoute.buildTransitions] delegates to a [platform] specific
|
|
/// [PageTransitionsBuilder]. If a matching builder is not found, a builder
|
|
/// whose platform is null is used.
|
|
final PageTransitionsTheme pageTransitionsTheme;
|
|
|
|
/// The platform the material widgets should adapt to target.
|
|
///
|
|
/// Defaults to the current platform, as exposed by [defaultTargetPlatform].
|
|
/// This should be used in order to style UI elements according to platform
|
|
/// conventions.
|
|
///
|
|
/// Widgets from the material library should use this getter (via [Theme.of])
|
|
/// to determine the current platform for the purpose of emulating the
|
|
/// platform behavior (e.g. scrolling or haptic effects). Widgets and render
|
|
/// objects at lower layers that try to emulate the underlying platform
|
|
/// can depend on [defaultTargetPlatform] directly, or may require
|
|
/// that the target platform be provided as an argument. The
|
|
/// [dart:io.Platform] object should only be used directly when it's critical
|
|
/// to actually know the current platform, without any overrides possible (for
|
|
/// example, when a system API is about to be called).
|
|
///
|
|
/// In a test environment, the platform returned is [TargetPlatform.android]
|
|
/// regardless of the host platform. (Android was chosen because the tests
|
|
/// were originally written assuming Android-like behavior, and we added
|
|
/// platform adaptations for other platforms later). Tests can check behavior
|
|
/// for other platforms by setting the [platform] of the [Theme] explicitly to
|
|
/// another [TargetPlatform] value, or by setting
|
|
/// [debugDefaultTargetPlatformOverride].
|
|
///
|
|
/// Determines the defaults for [typography] and [materialTapTargetSize].
|
|
final TargetPlatform platform;
|
|
|
|
/// A theme for customizing the colors, thickness, and shape of [Scrollbar]s.
|
|
final ScrollbarThemeData scrollbarTheme;
|
|
|
|
/// Defines the appearance of ink splashes produces by [InkWell]
|
|
/// and [InkResponse].
|
|
///
|
|
/// See also:
|
|
///
|
|
/// * [InkSplash.splashFactory], which defines the default splash.
|
|
/// * [InkRipple.splashFactory], which defines a splash that spreads out
|
|
/// more aggressively than the default.
|
|
/// * [InkSparkle.splashFactory], which defines a more aggressive and organic
|
|
/// splash with sparkle effects.
|
|
final InteractiveInkFeatureFactory splashFactory;
|
|
|
|
/// A temporary flag that can be used to opt-out of Material 3 features.
|
|
///
|
|
/// This flag is _true_ by default. If false, then components will
|
|
/// continue to use the colors, typography and other features of
|
|
/// Material 2.
|
|
///
|
|
/// In the long run this flag will be deprecated and eventually
|
|
/// only Material 3 will be supported. We recommend that applications
|
|
/// migrate to Material 3 as soon as that's practical. Until that migration
|
|
/// is complete, this flag can be set to false.
|
|
///
|
|
/// ## Defaults
|
|
///
|
|
/// If a [ThemeData] is _constructed_ with [useMaterial3] set to true, then
|
|
/// some properties will get updated defaults. However, the
|
|
/// [ThemeData.copyWith] method with [useMaterial3] set to true will _not_
|
|
/// change any of these properties in the resulting [ThemeData].
|
|
///
|
|
/// <style>table,td,th { border-collapse: collapse; padding: 0.45em; } td { border: 1px solid }</style>
|
|
///
|
|
/// | Property | Material 3 default | Material 2 default |
|
|
/// | :-------------- | :----------------------------- | :----------------------------- |
|
|
/// | [colorScheme] | M3 baseline light color scheme | M2 baseline light color scheme |
|
|
/// | [typography] | [Typography.material2021] | [Typography.material2014] |
|
|
/// | [splashFactory] | [InkSparkle]* or [InkRipple] | [InkSplash] |
|
|
///
|
|
/// \* if the target platform is Android and the app is not
|
|
/// running on the web, otherwise it will fallback to [InkRipple].
|
|
///
|
|
/// If [brightness] is [Brightness.dark] then the default color scheme will
|
|
/// be either the M3 baseline dark color scheme or the M2 baseline dark color
|
|
/// scheme depending on [useMaterial3].
|
|
///
|
|
/// ## Affected widgets
|
|
///
|
|
/// This flag affects styles and components.
|
|
///
|
|
/// ### Styles
|
|
/// * Color: [ColorScheme], [Material] (see table above)
|
|
/// * Shape: (see components below)
|
|
/// * Typography: [Typography] (see table above)
|
|
///
|
|
/// ### Components
|
|
/// * Badges: [Badge]
|
|
/// * Bottom app bar: [BottomAppBar]
|
|
/// * Bottom sheets: [BottomSheet]
|
|
/// * Buttons
|
|
/// - Common buttons: [ElevatedButton], [FilledButton], [FilledButton.tonal], [OutlinedButton], [TextButton]
|
|
/// - FAB: [FloatingActionButton], [FloatingActionButton.extended]
|
|
/// - Icon buttons: [IconButton], [IconButton.filled] (*new*), [IconButton.filledTonal], [IconButton.outlined]
|
|
/// - Segmented buttons: [SegmentedButton] (replacing [ToggleButtons])
|
|
/// * Cards: [Card]
|
|
/// * Checkbox: [Checkbox], [CheckboxListTile]
|
|
/// * Chips:
|
|
/// - [ActionChip] (used for Assist and Suggestion chips),
|
|
/// - [FilterChip], [ChoiceChip] (used for single selection filter chips),
|
|
/// - [InputChip]
|
|
/// * Date pickers: [showDatePicker], [showDateRangePicker], [DatePickerDialog], [DateRangePickerDialog], [InputDatePickerFormField]
|
|
/// * Dialogs: [AlertDialog], [Dialog.fullscreen]
|
|
/// * Divider: [Divider], [VerticalDivider]
|
|
/// * Lists: [ListTile]
|
|
/// * Menus: [MenuAnchor], [DropdownMenu], [MenuBar]
|
|
/// * Navigation bar: [NavigationBar] (replacing [BottomNavigationBar])
|
|
/// * Navigation drawer: [NavigationDrawer] (replacing [Drawer])
|
|
/// * Navigation rail: [NavigationRail]
|
|
/// * Progress indicators: [CircularProgressIndicator], [LinearProgressIndicator]
|
|
/// * Radio button: [Radio], [RadioListTile]
|
|
/// * Search: [SearchBar], [SearchAnchor],
|
|
/// * Snack bar: [SnackBar]
|
|
/// * Slider: [Slider], [RangeSlider]
|
|
/// * Switch: [Switch], [SwitchListTile]
|
|
/// * Tabs: [TabBar], [TabBar.secondary]
|
|
/// * TextFields: [TextField] together with its [InputDecoration]
|
|
/// * Time pickers: [showTimePicker], [TimePickerDialog]
|
|
/// * Top app bar: [AppBar], [SliverAppBar], [SliverAppBar.medium], [SliverAppBar.large]
|
|
///
|
|
/// In addition, this flag enables features introduced in Android 12.
|
|
/// * Stretch overscroll: [MaterialScrollBehavior]
|
|
/// * Ripple: `splashFactory` (see table above)
|
|
///
|
|
/// See also:
|
|
///
|
|
/// * [Material 3 specification](https://m3.material.io/).
|
|
final bool useMaterial3;
|
|
|
|
/// The density value for specifying the compactness of various UI components.
|
|
///
|
|
/// {@template flutter.material.themedata.visualDensity}
|
|
/// Density, in the context of a UI, is the vertical and horizontal
|
|
/// "compactness" of the elements in the UI. It is unitless, since it means
|
|
/// different things to different UI elements. For buttons, it affects the
|
|
/// spacing around the centered label of the button. For lists, it affects the
|
|
/// distance between baselines of entries in the list.
|
|
///
|
|
/// Typically, density values are integral, but any value in range may be
|
|
/// used. The range includes values from [VisualDensity.minimumDensity] (which
|
|
/// is -4), to [VisualDensity.maximumDensity] (which is 4), inclusive, where
|
|
/// negative values indicate a denser, more compact, UI, and positive values
|
|
/// indicate a less dense, more expanded, UI. If a component doesn't support
|
|
/// the value given, it will clamp to the nearest supported value.
|
|
///
|
|
/// The default for visual densities is zero for both vertical and horizontal
|
|
/// densities, which corresponds to the default visual density of components
|
|
/// in the Material Design specification.
|
|
///
|
|
/// As a rule of thumb, a change of 1 or -1 in density corresponds to 4
|
|
/// logical pixels. However, this is not a strict relationship since
|
|
/// components interpret the density values appropriately for their needs.
|
|
///
|
|
/// A larger value translates to a spacing increase (less dense), and a
|
|
/// smaller value translates to a spacing decrease (more dense).
|
|
///
|
|
/// In Material Design 3, the [visualDensity] does not override the value of
|
|
/// [IconButton.visualDensity] which defaults to [VisualDensity.standard]
|
|
/// for all platforms. To override the default value of [IconButton.visualDensity],
|
|
/// use [ThemeData.iconButtonTheme] instead.
|
|
/// {@endtemplate}
|
|
final VisualDensity visualDensity;
|
|
|
|
// COLOR
|
|
|
|
/// The default color of [MaterialType.canvas] [Material].
|
|
final Color canvasColor;
|
|
|
|
/// The color of [Material] when it is used as a [Card].
|
|
final Color cardColor;
|
|
|
|
/// {@macro flutter.material.color_scheme.ColorScheme}
|
|
///
|
|
/// This property was added much later than the theme's set of highly specific
|
|
/// colors, like [cardColor], [canvasColor] etc. New components can be defined
|
|
/// exclusively in terms of [colorScheme]. Existing components will gradually
|
|
/// migrate to it, to the extent that is possible without significant
|
|
/// backwards compatibility breaks.
|
|
final ColorScheme colorScheme;
|
|
|
|
/// The color used for widgets that are inoperative, regardless of
|
|
/// their state. For example, a disabled checkbox (which may be
|
|
/// checked or unchecked).
|
|
final Color disabledColor;
|
|
|
|
/// The color of [Divider]s and [PopupMenuDivider]s, also used
|
|
/// between [ListTile]s, between rows in [DataTable]s, and so forth.
|
|
///
|
|
/// To create an appropriate [BorderSide] that uses this color, consider
|
|
/// [Divider.createBorderSide].
|
|
final Color dividerColor;
|
|
|
|
/// The focus color used indicate that a component has the input focus.
|
|
final Color focusColor;
|
|
|
|
/// The highlight color used during ink splash animations or to
|
|
/// indicate an item in a menu is selected.
|
|
final Color highlightColor;
|
|
|
|
/// The color to use for hint text or placeholder text, e.g. in
|
|
/// [TextField] fields.
|
|
final Color hintColor;
|
|
|
|
/// The hover color used to indicate when a pointer is hovering over a
|
|
/// component.
|
|
final Color hoverColor;
|
|
|
|
/// The background color for major parts of the app (toolbars, tab bars, etc)
|
|
///
|
|
/// The theme's [colorScheme] property contains [ColorScheme.primary], as
|
|
/// well as a color that contrasts well with the primary color called
|
|
/// [ColorScheme.onPrimary]. It might be simpler to just configure an app's
|
|
/// visuals in terms of the theme's [colorScheme].
|
|
final Color primaryColor;
|
|
|
|
/// A darker version of the [primaryColor].
|
|
final Color primaryColorDark;
|
|
|
|
/// A lighter version of the [primaryColor].
|
|
final Color primaryColorLight;
|
|
|
|
/// The default color of the [Material] that underlies the [Scaffold]. The
|
|
/// background color for a typical material app or a page within the app.
|
|
final Color scaffoldBackgroundColor;
|
|
|
|
/// The color of the header of a [PaginatedDataTable] when there are selected rows.
|
|
// According to the spec for data tables:
|
|
// https://material.io/archive/guidelines/components/data-tables.html#data-tables-tables-within-cards
|
|
// ...this should be the "50-value of secondary app color".
|
|
final Color secondaryHeaderColor;
|
|
|
|
/// The color that the [Material] widget uses to draw elevation shadows.
|
|
///
|
|
/// Defaults to fully opaque black.
|
|
///
|
|
/// Shadows can be difficult to see in a dark theme, so the elevation of a
|
|
/// surface should be rendered with an "overlay" in addition to the shadow.
|
|
/// As the elevation of the component increases, the overlay increases in
|
|
/// opacity. The [applyElevationOverlayColor] property turns the elevation
|
|
/// overlay on or off for dark themes.
|
|
final Color shadowColor;
|
|
|
|
/// The color of ink splashes.
|
|
///
|
|
/// See also:
|
|
/// * [splashFactory], which defines the appearance of the splash.
|
|
final Color splashColor;
|
|
|
|
/// The color used for widgets in their inactive (but enabled)
|
|
/// state. For example, an unchecked checkbox. See also [disabledColor].
|
|
final Color unselectedWidgetColor;
|
|
|
|
// TYPOGRAPHY & ICONOGRAPHY
|
|
|
|
/// An icon theme that contrasts with the card and canvas colors.
|
|
final IconThemeData iconTheme;
|
|
|
|
/// An icon theme that contrasts with the primary color.
|
|
final IconThemeData primaryIconTheme;
|
|
|
|
/// A text theme that contrasts with the primary color.
|
|
final TextTheme primaryTextTheme;
|
|
|
|
/// Text with a color that contrasts with the card and canvas colors.
|
|
final TextTheme textTheme;
|
|
|
|
/// The color and geometry [TextTheme] values used to configure [textTheme].
|
|
///
|
|
/// Defaults to a [platform]-appropriate typography.
|
|
final Typography typography;
|
|
|
|
// COMPONENT THEMES
|
|
|
|
/// A theme for customizing icons of [BackButtonIcon], [CloseButtonIcon],
|
|
/// [DrawerButtonIcon], or [EndDrawerButtonIcon].
|
|
final ActionIconThemeData? actionIconTheme;
|
|
|
|
/// A theme for customizing the color, elevation, brightness, iconTheme and
|
|
/// textTheme of [AppBar]s.
|
|
final AppBarTheme appBarTheme;
|
|
|
|
/// A theme for customizing the color of [Badge]s.
|
|
final BadgeThemeData badgeTheme;
|
|
|
|
/// A theme for customizing the color and text style of a [MaterialBanner].
|
|
final MaterialBannerThemeData bannerTheme;
|
|
|
|
/// A theme for customizing the shape, elevation, and color of a [BottomAppBar].
|
|
final BottomAppBarTheme bottomAppBarTheme;
|
|
|
|
/// A theme for customizing the appearance and layout of [BottomNavigationBar]
|
|
/// widgets.
|
|
final BottomNavigationBarThemeData bottomNavigationBarTheme;
|
|
|
|
/// A theme for customizing the color, elevation, and shape of a bottom sheet.
|
|
final BottomSheetThemeData bottomSheetTheme;
|
|
|
|
/// Defines the default configuration of button widgets, like [DropdownButton]
|
|
/// and [ButtonBar].
|
|
final ButtonThemeData buttonTheme;
|
|
|
|
/// The colors and styles used to render [Card].
|
|
///
|
|
/// This is the value returned from [CardTheme.of].
|
|
final CardThemeData cardTheme;
|
|
|
|
/// A theme for customizing the appearance and layout of [Checkbox] widgets.
|
|
final CheckboxThemeData checkboxTheme;
|
|
|
|
/// The colors and styles used to render [Chip]s.
|
|
///
|
|
/// This is the value returned from [ChipTheme.of].
|
|
final ChipThemeData chipTheme;
|
|
|
|
/// A theme for customizing the appearance and layout of [DataTable]
|
|
/// widgets.
|
|
final DataTableThemeData dataTableTheme;
|
|
|
|
/// A theme for customizing the appearance and layout of [DatePickerDialog]
|
|
/// widgets.
|
|
final DatePickerThemeData datePickerTheme;
|
|
|
|
/// A theme for customizing the shape of a dialog.
|
|
final DialogThemeData dialogTheme;
|
|
|
|
/// A theme for customizing the color, thickness, and indents of [Divider]s,
|
|
/// [VerticalDivider]s, etc.
|
|
final DividerThemeData dividerTheme;
|
|
|
|
/// A theme for customizing the appearance and layout of [Drawer] widgets.
|
|
final DrawerThemeData drawerTheme;
|
|
|
|
/// A theme for customizing the appearance and layout of [DropdownMenu] widgets.
|
|
final DropdownMenuThemeData dropdownMenuTheme;
|
|
|
|
/// A theme for customizing the appearance and internal layout of
|
|
/// [ElevatedButton]s.
|
|
final ElevatedButtonThemeData elevatedButtonTheme;
|
|
|
|
/// A theme for customizing the visual properties of [ExpansionTile]s.
|
|
final ExpansionTileThemeData expansionTileTheme;
|
|
|
|
/// A theme for customizing the appearance and internal layout of
|
|
/// [FilledButton]s.
|
|
final FilledButtonThemeData filledButtonTheme;
|
|
|
|
/// A theme for customizing the shape, elevation, and color of a
|
|
/// [FloatingActionButton].
|
|
final FloatingActionButtonThemeData floatingActionButtonTheme;
|
|
|
|
/// A theme for customizing the appearance and internal layout of
|
|
/// [IconButton]s.
|
|
final IconButtonThemeData iconButtonTheme;
|
|
|
|
/// A theme for customizing the appearance of [ListTile] widgets.
|
|
final ListTileThemeData listTileTheme;
|
|
|
|
/// A theme for customizing the color, shape, elevation, and other [MenuStyle]
|
|
/// aspects of the menu bar created by the [MenuBar] widget.
|
|
final MenuBarThemeData menuBarTheme;
|
|
|
|
/// A theme for customizing the color, shape, elevation, and text style of
|
|
/// cascading menu buttons created by [SubmenuButton] or [MenuItemButton].
|
|
final MenuButtonThemeData menuButtonTheme;
|
|
|
|
/// A theme for customizing the color, shape, elevation, and other [MenuStyle]
|
|
/// attributes of menus created by the [SubmenuButton] widget.
|
|
final MenuThemeData menuTheme;
|
|
|
|
/// A theme for customizing the background color, text style, and icon themes
|
|
/// of a [NavigationBar].
|
|
final NavigationBarThemeData navigationBarTheme;
|
|
|
|
/// A theme for customizing the background color, text style, and icon themes
|
|
/// of a [NavigationDrawer].
|
|
final NavigationDrawerThemeData navigationDrawerTheme;
|
|
|
|
/// A theme for customizing the background color, elevation, text style, and
|
|
/// icon themes of a [NavigationRail].
|
|
final NavigationRailThemeData navigationRailTheme;
|
|
|
|
/// A theme for customizing the appearance and internal layout of
|
|
/// [OutlinedButton]s.
|
|
final OutlinedButtonThemeData outlinedButtonTheme;
|
|
|
|
/// A theme for customizing the color, shape, elevation, and text style of
|
|
/// popup menus.
|
|
final PopupMenuThemeData popupMenuTheme;
|
|
|
|
/// A theme for customizing the appearance and layout of [ProgressIndicator] widgets.
|
|
final ProgressIndicatorThemeData progressIndicatorTheme;
|
|
|
|
/// A theme for customizing the appearance and layout of [Radio] widgets.
|
|
final RadioThemeData radioTheme;
|
|
|
|
/// A theme for customizing the appearance and layout of [SearchBar] widgets.
|
|
final SearchBarThemeData searchBarTheme;
|
|
|
|
/// A theme for customizing the appearance and layout of search views created by [SearchAnchor] widgets.
|
|
final SearchViewThemeData searchViewTheme;
|
|
|
|
/// A theme for customizing the appearance and layout of [SegmentedButton] widgets.
|
|
final SegmentedButtonThemeData segmentedButtonTheme;
|
|
|
|
/// The colors and shapes used to render [Slider].
|
|
///
|
|
/// This is the value returned from [SliderTheme.of].
|
|
final SliderThemeData sliderTheme;
|
|
|
|
/// A theme for customizing colors, shape, elevation, and behavior of a [SnackBar].
|
|
final SnackBarThemeData snackBarTheme;
|
|
|
|
/// A theme for customizing the appearance and layout of [Switch] widgets.
|
|
final SwitchThemeData switchTheme;
|
|
|
|
/// A theme for customizing the size, shape, and color of the tab bar indicator.
|
|
final TabBarThemeData tabBarTheme;
|
|
|
|
/// A theme for customizing the appearance and internal layout of
|
|
/// [TextButton]s.
|
|
final TextButtonThemeData textButtonTheme;
|
|
|
|
/// A theme for customizing the appearance and layout of [TextField] widgets.
|
|
final TextSelectionThemeData textSelectionTheme;
|
|
|
|
/// A theme for customizing the appearance and layout of time picker widgets.
|
|
final TimePickerThemeData timePickerTheme;
|
|
|
|
/// Defines the default configuration of [ToggleButtons] widgets.
|
|
final ToggleButtonsThemeData toggleButtonsTheme;
|
|
|
|
/// A theme for customizing the visual properties of [Tooltip]s.
|
|
///
|
|
/// This is the value returned from [TooltipTheme.of].
|
|
final TooltipThemeData tooltipTheme;
|
|
|
|
/// A theme for customizing the appearance and layout of [ButtonBar] widgets.
|
|
@Deprecated(
|
|
'Use OverflowBar instead. '
|
|
'This feature was deprecated after v3.21.0-10.0.pre.',
|
|
)
|
|
ButtonBarThemeData get buttonBarTheme => _buttonBarTheme!;
|
|
final ButtonBarThemeData? _buttonBarTheme;
|
|
|
|
/// The background color of [Dialog] elements.
|
|
@Deprecated(
|
|
'Use DialogThemeData.backgroundColor instead. '
|
|
'This feature was deprecated after v3.27.0-0.1.pre.',
|
|
)
|
|
final Color dialogBackgroundColor;
|
|
|
|
/// The color of the selected tab indicator in a tab bar.
|
|
@Deprecated(
|
|
'Use TabBarThemeData.indicatorColor instead. '
|
|
'This feature was deprecated after v3.28.0-1.0.pre.',
|
|
)
|
|
final Color indicatorColor;
|
|
|
|
/// Creates a copy of this theme but with the given fields replaced with the new values.
|
|
///
|
|
/// The [brightness] value is applied to the [colorScheme].
|
|
ThemeData copyWith({
|
|
// For the sanity of the reader, make sure these properties are in the same
|
|
// order in every place that they are separated by section comments (e.g.
|
|
// GENERAL CONFIGURATION). Each section except for deprecations should be
|
|
// alphabetical by symbol name.
|
|
|
|
// GENERAL CONFIGURATION
|
|
Iterable<Adaptation<Object>>? adaptations,
|
|
bool? applyElevationOverlayColor,
|
|
NoDefaultCupertinoThemeData? cupertinoOverrideTheme,
|
|
Iterable<ThemeExtension<dynamic>>? extensions,
|
|
InputDecorationTheme? inputDecorationTheme,
|
|
MaterialTapTargetSize? materialTapTargetSize,
|
|
PageTransitionsTheme? pageTransitionsTheme,
|
|
TargetPlatform? platform,
|
|
ScrollbarThemeData? scrollbarTheme,
|
|
InteractiveInkFeatureFactory? splashFactory,
|
|
VisualDensity? visualDensity,
|
|
// COLOR
|
|
ColorScheme? colorScheme,
|
|
Brightness? brightness,
|
|
// [colorScheme] is the preferred way to configure colors. The [Color] properties
|
|
// listed below (as well as primarySwatch) will gradually be phased out, see
|
|
// https://github.com/flutter/flutter/issues/91772.
|
|
Color? canvasColor,
|
|
Color? cardColor,
|
|
Color? disabledColor,
|
|
Color? dividerColor,
|
|
Color? focusColor,
|
|
Color? highlightColor,
|
|
Color? hintColor,
|
|
Color? hoverColor,
|
|
Color? primaryColor,
|
|
Color? primaryColorDark,
|
|
Color? primaryColorLight,
|
|
Color? scaffoldBackgroundColor,
|
|
Color? secondaryHeaderColor,
|
|
Color? shadowColor,
|
|
Color? splashColor,
|
|
Color? unselectedWidgetColor,
|
|
// TYPOGRAPHY & ICONOGRAPHY
|
|
IconThemeData? iconTheme,
|
|
IconThemeData? primaryIconTheme,
|
|
TextTheme? primaryTextTheme,
|
|
TextTheme? textTheme,
|
|
Typography? typography,
|
|
// COMPONENT THEMES
|
|
ActionIconThemeData? actionIconTheme,
|
|
AppBarTheme? appBarTheme,
|
|
BadgeThemeData? badgeTheme,
|
|
MaterialBannerThemeData? bannerTheme,
|
|
BottomAppBarTheme? bottomAppBarTheme,
|
|
BottomNavigationBarThemeData? bottomNavigationBarTheme,
|
|
BottomSheetThemeData? bottomSheetTheme,
|
|
ButtonThemeData? buttonTheme,
|
|
Object? cardTheme,
|
|
CheckboxThemeData? checkboxTheme,
|
|
ChipThemeData? chipTheme,
|
|
DataTableThemeData? dataTableTheme,
|
|
DatePickerThemeData? datePickerTheme,
|
|
// TODO(QuncCccccc): Change the parameter type to DialogThemeData
|
|
Object? dialogTheme,
|
|
DividerThemeData? dividerTheme,
|
|
DrawerThemeData? drawerTheme,
|
|
DropdownMenuThemeData? dropdownMenuTheme,
|
|
ElevatedButtonThemeData? elevatedButtonTheme,
|
|
ExpansionTileThemeData? expansionTileTheme,
|
|
FilledButtonThemeData? filledButtonTheme,
|
|
FloatingActionButtonThemeData? floatingActionButtonTheme,
|
|
IconButtonThemeData? iconButtonTheme,
|
|
ListTileThemeData? listTileTheme,
|
|
MenuBarThemeData? menuBarTheme,
|
|
MenuButtonThemeData? menuButtonTheme,
|
|
MenuThemeData? menuTheme,
|
|
NavigationBarThemeData? navigationBarTheme,
|
|
NavigationDrawerThemeData? navigationDrawerTheme,
|
|
NavigationRailThemeData? navigationRailTheme,
|
|
OutlinedButtonThemeData? outlinedButtonTheme,
|
|
PopupMenuThemeData? popupMenuTheme,
|
|
ProgressIndicatorThemeData? progressIndicatorTheme,
|
|
RadioThemeData? radioTheme,
|
|
SearchBarThemeData? searchBarTheme,
|
|
SearchViewThemeData? searchViewTheme,
|
|
SegmentedButtonThemeData? segmentedButtonTheme,
|
|
SliderThemeData? sliderTheme,
|
|
SnackBarThemeData? snackBarTheme,
|
|
SwitchThemeData? switchTheme,
|
|
// TODO(QuncCccccc): Change the parameter type to TabBarThemeData
|
|
Object? tabBarTheme,
|
|
TextButtonThemeData? textButtonTheme,
|
|
TextSelectionThemeData? textSelectionTheme,
|
|
TimePickerThemeData? timePickerTheme,
|
|
ToggleButtonsThemeData? toggleButtonsTheme,
|
|
TooltipThemeData? tooltipTheme,
|
|
// DEPRECATED (newest deprecations at the bottom)
|
|
@Deprecated(
|
|
'Use a ThemeData constructor (.from, .light, or .dark) instead. '
|
|
'These constructors all have a useMaterial3 argument, '
|
|
'and they set appropriate default values based on its value. '
|
|
'See the useMaterial3 API documentation for full details. '
|
|
'This feature was deprecated after v3.13.0-0.2.pre.',
|
|
)
|
|
bool? useMaterial3,
|
|
@Deprecated(
|
|
'Use OverflowBar instead. '
|
|
'This feature was deprecated after v3.21.0-10.0.pre.',
|
|
)
|
|
ButtonBarThemeData? buttonBarTheme,
|
|
@Deprecated(
|
|
'Use DialogThemeData.backgroundColor instead. '
|
|
'This feature was deprecated after v3.27.0-0.1.pre.',
|
|
)
|
|
Color? dialogBackgroundColor,
|
|
@Deprecated(
|
|
'Use TabBarThemeData.indicatorColor instead. '
|
|
'This feature was deprecated after v3.28.0-1.0.pre.',
|
|
)
|
|
Color? indicatorColor,
|
|
}) {
|
|
cupertinoOverrideTheme = cupertinoOverrideTheme?.noDefault();
|
|
|
|
// TODO(QuncCccccc): Clean it up once the type of `cardTheme` is changed to `CardThemeData`
|
|
if (cardTheme != null) {
|
|
if (cardTheme is CardTheme) {
|
|
cardTheme = cardTheme.data;
|
|
} else if (cardTheme is! CardThemeData) {
|
|
throw ArgumentError('cardTheme must be either a CardThemeData or a CardTheme');
|
|
}
|
|
}
|
|
|
|
// TODO(QuncCccccc): Clean this up once the type of `dialogTheme` is changed to `DialogThemeData`
|
|
if (dialogTheme != null) {
|
|
if (dialogTheme is DialogTheme) {
|
|
dialogTheme = dialogTheme.data;
|
|
} else if (dialogTheme is! DialogThemeData) {
|
|
throw ArgumentError('dialogTheme must be either a DialogThemeData or a DialogTheme');
|
|
}
|
|
}
|
|
|
|
// TODO(QuncCccccc): Clean this up once the type of `tabBarTheme` is changed to `TabBarThemeData`
|
|
if (tabBarTheme != null) {
|
|
if (tabBarTheme is TabBarTheme) {
|
|
tabBarTheme = tabBarTheme.data;
|
|
} else if (tabBarTheme is! TabBarThemeData) {
|
|
throw ArgumentError('tabBarTheme must be either a TabBarThemeData or a TabBarTheme');
|
|
}
|
|
}
|
|
return ThemeData.raw(
|
|
// For the sanity of the reader, make sure these properties are in the same
|
|
// order in every place that they are separated by section comments (e.g.
|
|
// GENERAL CONFIGURATION). Each section except for deprecations should be
|
|
// alphabetical by symbol name.
|
|
|
|
// GENERAL CONFIGURATION
|
|
adaptationMap: adaptations != null ? _createAdaptationMap(adaptations) : adaptationMap,
|
|
applyElevationOverlayColor: applyElevationOverlayColor ?? this.applyElevationOverlayColor,
|
|
cupertinoOverrideTheme: cupertinoOverrideTheme ?? this.cupertinoOverrideTheme,
|
|
extensions: (extensions != null) ? _themeExtensionIterableToMap(extensions) : this.extensions,
|
|
inputDecorationTheme: inputDecorationTheme ?? this.inputDecorationTheme,
|
|
materialTapTargetSize: materialTapTargetSize ?? this.materialTapTargetSize,
|
|
pageTransitionsTheme: pageTransitionsTheme ?? this.pageTransitionsTheme,
|
|
platform: platform ?? this.platform,
|
|
scrollbarTheme: scrollbarTheme ?? this.scrollbarTheme,
|
|
splashFactory: splashFactory ?? this.splashFactory,
|
|
// When deprecated useMaterial3 removed, maintain `this.useMaterial3` here
|
|
// for == evaluation.
|
|
useMaterial3: useMaterial3 ?? this.useMaterial3,
|
|
visualDensity: visualDensity ?? this.visualDensity,
|
|
// COLOR
|
|
canvasColor: canvasColor ?? this.canvasColor,
|
|
cardColor: cardColor ?? this.cardColor,
|
|
colorScheme: (colorScheme ?? this.colorScheme).copyWith(brightness: brightness),
|
|
disabledColor: disabledColor ?? this.disabledColor,
|
|
dividerColor: dividerColor ?? this.dividerColor,
|
|
focusColor: focusColor ?? this.focusColor,
|
|
highlightColor: highlightColor ?? this.highlightColor,
|
|
hintColor: hintColor ?? this.hintColor,
|
|
hoverColor: hoverColor ?? this.hoverColor,
|
|
primaryColor: primaryColor ?? this.primaryColor,
|
|
primaryColorDark: primaryColorDark ?? this.primaryColorDark,
|
|
primaryColorLight: primaryColorLight ?? this.primaryColorLight,
|
|
scaffoldBackgroundColor: scaffoldBackgroundColor ?? this.scaffoldBackgroundColor,
|
|
secondaryHeaderColor: secondaryHeaderColor ?? this.secondaryHeaderColor,
|
|
shadowColor: shadowColor ?? this.shadowColor,
|
|
splashColor: splashColor ?? this.splashColor,
|
|
unselectedWidgetColor: unselectedWidgetColor ?? this.unselectedWidgetColor,
|
|
// TYPOGRAPHY & ICONOGRAPHY
|
|
iconTheme: iconTheme ?? this.iconTheme,
|
|
primaryIconTheme: primaryIconTheme ?? this.primaryIconTheme,
|
|
primaryTextTheme: primaryTextTheme ?? this.primaryTextTheme,
|
|
textTheme: textTheme ?? this.textTheme,
|
|
typography: typography ?? this.typography,
|
|
// COMPONENT THEMES
|
|
actionIconTheme: actionIconTheme ?? this.actionIconTheme,
|
|
appBarTheme: appBarTheme ?? this.appBarTheme,
|
|
badgeTheme: badgeTheme ?? this.badgeTheme,
|
|
bannerTheme: bannerTheme ?? this.bannerTheme,
|
|
bottomAppBarTheme: bottomAppBarTheme ?? this.bottomAppBarTheme,
|
|
bottomNavigationBarTheme: bottomNavigationBarTheme ?? this.bottomNavigationBarTheme,
|
|
bottomSheetTheme: bottomSheetTheme ?? this.bottomSheetTheme,
|
|
buttonTheme: buttonTheme ?? this.buttonTheme,
|
|
cardTheme: cardTheme as CardThemeData? ?? this.cardTheme,
|
|
checkboxTheme: checkboxTheme ?? this.checkboxTheme,
|
|
chipTheme: chipTheme ?? this.chipTheme,
|
|
dataTableTheme: dataTableTheme ?? this.dataTableTheme,
|
|
datePickerTheme: datePickerTheme ?? this.datePickerTheme,
|
|
dialogTheme: dialogTheme as DialogThemeData? ?? this.dialogTheme,
|
|
dividerTheme: dividerTheme ?? this.dividerTheme,
|
|
drawerTheme: drawerTheme ?? this.drawerTheme,
|
|
dropdownMenuTheme: dropdownMenuTheme ?? this.dropdownMenuTheme,
|
|
elevatedButtonTheme: elevatedButtonTheme ?? this.elevatedButtonTheme,
|
|
expansionTileTheme: expansionTileTheme ?? this.expansionTileTheme,
|
|
filledButtonTheme: filledButtonTheme ?? this.filledButtonTheme,
|
|
floatingActionButtonTheme: floatingActionButtonTheme ?? this.floatingActionButtonTheme,
|
|
iconButtonTheme: iconButtonTheme ?? this.iconButtonTheme,
|
|
listTileTheme: listTileTheme ?? this.listTileTheme,
|
|
menuBarTheme: menuBarTheme ?? this.menuBarTheme,
|
|
menuButtonTheme: menuButtonTheme ?? this.menuButtonTheme,
|
|
menuTheme: menuTheme ?? this.menuTheme,
|
|
navigationBarTheme: navigationBarTheme ?? this.navigationBarTheme,
|
|
navigationDrawerTheme: navigationDrawerTheme ?? this.navigationDrawerTheme,
|
|
navigationRailTheme: navigationRailTheme ?? this.navigationRailTheme,
|
|
outlinedButtonTheme: outlinedButtonTheme ?? this.outlinedButtonTheme,
|
|
popupMenuTheme: popupMenuTheme ?? this.popupMenuTheme,
|
|
progressIndicatorTheme: progressIndicatorTheme ?? this.progressIndicatorTheme,
|
|
radioTheme: radioTheme ?? this.radioTheme,
|
|
searchBarTheme: searchBarTheme ?? this.searchBarTheme,
|
|
searchViewTheme: searchViewTheme ?? this.searchViewTheme,
|
|
segmentedButtonTheme: segmentedButtonTheme ?? this.segmentedButtonTheme,
|
|
sliderTheme: sliderTheme ?? this.sliderTheme,
|
|
snackBarTheme: snackBarTheme ?? this.snackBarTheme,
|
|
switchTheme: switchTheme ?? this.switchTheme,
|
|
tabBarTheme: tabBarTheme as TabBarThemeData? ?? this.tabBarTheme,
|
|
textButtonTheme: textButtonTheme ?? this.textButtonTheme,
|
|
textSelectionTheme: textSelectionTheme ?? this.textSelectionTheme,
|
|
timePickerTheme: timePickerTheme ?? this.timePickerTheme,
|
|
toggleButtonsTheme: toggleButtonsTheme ?? this.toggleButtonsTheme,
|
|
tooltipTheme: tooltipTheme ?? this.tooltipTheme,
|
|
// DEPRECATED (newest deprecations at the bottom)
|
|
buttonBarTheme: buttonBarTheme ?? _buttonBarTheme,
|
|
dialogBackgroundColor: dialogBackgroundColor ?? this.dialogBackgroundColor,
|
|
indicatorColor: indicatorColor ?? this.indicatorColor,
|
|
);
|
|
}
|
|
|
|
// The number 5 was chosen without any real science or research behind it. It
|
|
// just seemed like a number that's not too big (we should be able to fit 5
|
|
// copies of ThemeData in memory comfortably) and not too small (most apps
|
|
// shouldn't have more than 5 theme/localization pairs).
|
|
static const int _localizedThemeDataCacheSize = 5;
|
|
|
|
/// Caches localized themes to speed up the [localize] method.
|
|
static final _FifoCache<_IdentityThemeDataCacheKey, ThemeData> _localizedThemeDataCache =
|
|
_FifoCache<_IdentityThemeDataCacheKey, ThemeData>(_localizedThemeDataCacheSize);
|
|
|
|
/// Returns a new theme built by merging the text geometry provided by the
|
|
/// [localTextGeometry] theme with the [baseTheme].
|
|
///
|
|
/// For those text styles in the [baseTheme] whose [TextStyle.inherit] is set
|
|
/// to true, the returned theme's text styles inherit the geometric properties
|
|
/// of [localTextGeometry]. The resulting text styles' [TextStyle.inherit] is
|
|
/// set to those provided by [localTextGeometry].
|
|
static ThemeData localize(ThemeData baseTheme, TextTheme localTextGeometry) {
|
|
// WARNING: this method memoizes the result in a cache based on the
|
|
// previously seen baseTheme and localTextGeometry. Memoization is safe
|
|
// because all inputs and outputs of this function are deeply immutable, and
|
|
// the computations are referentially transparent. It only short-circuits
|
|
// the computation if the new inputs are identical() to the previous ones.
|
|
// It does not use the == operator, which performs a costly deep comparison.
|
|
//
|
|
// When changing this method, make sure the memoization logic is correct.
|
|
// Remember:
|
|
//
|
|
// There are only two hard things in Computer Science: cache invalidation
|
|
// and naming things. -- Phil Karlton
|
|
|
|
return _localizedThemeDataCache.putIfAbsent(
|
|
_IdentityThemeDataCacheKey(baseTheme, localTextGeometry),
|
|
() {
|
|
return baseTheme.copyWith(
|
|
primaryTextTheme: localTextGeometry.merge(baseTheme.primaryTextTheme),
|
|
textTheme: localTextGeometry.merge(baseTheme.textTheme),
|
|
);
|
|
},
|
|
);
|
|
}
|
|
|
|
/// Determines whether the given [Color] is [Brightness.light] or
|
|
/// [Brightness.dark].
|
|
///
|
|
/// This compares the luminosity of the given color to a threshold value that
|
|
/// matches the Material Design specification.
|
|
static Brightness estimateBrightnessForColor(Color color) {
|
|
final double relativeLuminance = color.computeLuminance();
|
|
|
|
// See <https://www.w3.org/TR/WCAG20/#contrast-ratiodef>
|
|
// The spec says to use kThreshold=0.0525, but Material Design appears to bias
|
|
// more towards using light text than WCAG20 recommends. Material Design spec
|
|
// doesn't say what value to use, but 0.15 seemed close to what the Material
|
|
// Design spec shows for its color palette on
|
|
// <https://material.io/go/design-theming#color-color-palette>.
|
|
const double kThreshold = 0.15;
|
|
if ((relativeLuminance + 0.05) * (relativeLuminance + 0.05) > kThreshold) {
|
|
return Brightness.light;
|
|
}
|
|
return Brightness.dark;
|
|
}
|
|
|
|
/// Linearly interpolate between two [extensions].
|
|
///
|
|
/// Includes all theme extensions in [a] and [b].
|
|
///
|
|
/// {@macro dart.ui.shadow.lerp}
|
|
static Map<Object, ThemeExtension<dynamic>> _lerpThemeExtensions(
|
|
ThemeData a,
|
|
ThemeData b,
|
|
double t,
|
|
) {
|
|
// Lerp [a].
|
|
final Map<Object, ThemeExtension<dynamic>> newExtensions = a.extensions.map((
|
|
Object id,
|
|
ThemeExtension<dynamic> extensionA,
|
|
) {
|
|
final ThemeExtension<dynamic>? extensionB = b.extensions[id];
|
|
return MapEntry<Object, ThemeExtension<dynamic>>(id, extensionA.lerp(extensionB, t));
|
|
});
|
|
// Add [b]-only extensions.
|
|
newExtensions.addEntries(
|
|
b.extensions.entries.where(
|
|
(MapEntry<Object, ThemeExtension<dynamic>> entry) => !a.extensions.containsKey(entry.key),
|
|
),
|
|
);
|
|
|
|
return newExtensions;
|
|
}
|
|
|
|
/// Convert the [extensionsIterable] passed to [ThemeData.new] or [copyWith]
|
|
/// to the stored [extensions] map, where each entry's key consists of the extension's type.
|
|
static Map<Object, ThemeExtension<dynamic>> _themeExtensionIterableToMap(
|
|
Iterable<ThemeExtension<dynamic>> extensionsIterable,
|
|
) {
|
|
return Map<Object, ThemeExtension<dynamic>>.unmodifiable(<Object, ThemeExtension<dynamic>>{
|
|
// Strangely, the cast is necessary for tests to run.
|
|
for (final ThemeExtension<dynamic> extension in extensionsIterable)
|
|
extension.type: extension as ThemeExtension<ThemeExtension<dynamic>>,
|
|
});
|
|
}
|
|
|
|
/// Linearly interpolate between two themes.
|
|
///
|
|
/// {@macro dart.ui.shadow.lerp}
|
|
static ThemeData lerp(ThemeData a, ThemeData b, double t) {
|
|
if (identical(a, b)) {
|
|
return a;
|
|
}
|
|
return ThemeData.raw(
|
|
// For the sanity of the reader, make sure these properties are in the same
|
|
// order in every place that they are separated by section comments (e.g.
|
|
// GENERAL CONFIGURATION). Each section except for deprecations should be
|
|
// alphabetical by symbol name.
|
|
|
|
// GENERAL CONFIGURATION
|
|
adaptationMap: t < 0.5 ? a.adaptationMap : b.adaptationMap,
|
|
applyElevationOverlayColor:
|
|
t < 0.5 ? a.applyElevationOverlayColor : b.applyElevationOverlayColor,
|
|
cupertinoOverrideTheme: t < 0.5 ? a.cupertinoOverrideTheme : b.cupertinoOverrideTheme,
|
|
extensions: _lerpThemeExtensions(a, b, t),
|
|
inputDecorationTheme: t < 0.5 ? a.inputDecorationTheme : b.inputDecorationTheme,
|
|
materialTapTargetSize: t < 0.5 ? a.materialTapTargetSize : b.materialTapTargetSize,
|
|
pageTransitionsTheme: t < 0.5 ? a.pageTransitionsTheme : b.pageTransitionsTheme,
|
|
platform: t < 0.5 ? a.platform : b.platform,
|
|
scrollbarTheme: ScrollbarThemeData.lerp(a.scrollbarTheme, b.scrollbarTheme, t),
|
|
splashFactory: t < 0.5 ? a.splashFactory : b.splashFactory,
|
|
useMaterial3: t < 0.5 ? a.useMaterial3 : b.useMaterial3,
|
|
visualDensity: VisualDensity.lerp(a.visualDensity, b.visualDensity, t),
|
|
// COLOR
|
|
canvasColor: Color.lerp(a.canvasColor, b.canvasColor, t)!,
|
|
cardColor: Color.lerp(a.cardColor, b.cardColor, t)!,
|
|
colorScheme: ColorScheme.lerp(a.colorScheme, b.colorScheme, t),
|
|
disabledColor: Color.lerp(a.disabledColor, b.disabledColor, t)!,
|
|
dividerColor: Color.lerp(a.dividerColor, b.dividerColor, t)!,
|
|
focusColor: Color.lerp(a.focusColor, b.focusColor, t)!,
|
|
highlightColor: Color.lerp(a.highlightColor, b.highlightColor, t)!,
|
|
hintColor: Color.lerp(a.hintColor, b.hintColor, t)!,
|
|
hoverColor: Color.lerp(a.hoverColor, b.hoverColor, t)!,
|
|
primaryColor: Color.lerp(a.primaryColor, b.primaryColor, t)!,
|
|
primaryColorDark: Color.lerp(a.primaryColorDark, b.primaryColorDark, t)!,
|
|
primaryColorLight: Color.lerp(a.primaryColorLight, b.primaryColorLight, t)!,
|
|
scaffoldBackgroundColor: Color.lerp(a.scaffoldBackgroundColor, b.scaffoldBackgroundColor, t)!,
|
|
secondaryHeaderColor: Color.lerp(a.secondaryHeaderColor, b.secondaryHeaderColor, t)!,
|
|
shadowColor: Color.lerp(a.shadowColor, b.shadowColor, t)!,
|
|
splashColor: Color.lerp(a.splashColor, b.splashColor, t)!,
|
|
unselectedWidgetColor: Color.lerp(a.unselectedWidgetColor, b.unselectedWidgetColor, t)!,
|
|
// TYPOGRAPHY & ICONOGRAPHY
|
|
iconTheme: IconThemeData.lerp(a.iconTheme, b.iconTheme, t),
|
|
primaryIconTheme: IconThemeData.lerp(a.primaryIconTheme, b.primaryIconTheme, t),
|
|
primaryTextTheme: TextTheme.lerp(a.primaryTextTheme, b.primaryTextTheme, t),
|
|
textTheme: TextTheme.lerp(a.textTheme, b.textTheme, t),
|
|
typography: Typography.lerp(a.typography, b.typography, t),
|
|
// COMPONENT THEMES
|
|
actionIconTheme: ActionIconThemeData.lerp(a.actionIconTheme, b.actionIconTheme, t),
|
|
appBarTheme: AppBarTheme.lerp(a.appBarTheme, b.appBarTheme, t),
|
|
badgeTheme: BadgeThemeData.lerp(a.badgeTheme, b.badgeTheme, t),
|
|
bannerTheme: MaterialBannerThemeData.lerp(a.bannerTheme, b.bannerTheme, t),
|
|
bottomAppBarTheme: BottomAppBarTheme.lerp(a.bottomAppBarTheme, b.bottomAppBarTheme, t),
|
|
bottomNavigationBarTheme: BottomNavigationBarThemeData.lerp(
|
|
a.bottomNavigationBarTheme,
|
|
b.bottomNavigationBarTheme,
|
|
t,
|
|
),
|
|
bottomSheetTheme: BottomSheetThemeData.lerp(a.bottomSheetTheme, b.bottomSheetTheme, t)!,
|
|
buttonTheme: t < 0.5 ? a.buttonTheme : b.buttonTheme,
|
|
cardTheme: CardThemeData.lerp(a.cardTheme, b.cardTheme, t),
|
|
checkboxTheme: CheckboxThemeData.lerp(a.checkboxTheme, b.checkboxTheme, t),
|
|
chipTheme: ChipThemeData.lerp(a.chipTheme, b.chipTheme, t)!,
|
|
dataTableTheme: DataTableThemeData.lerp(a.dataTableTheme, b.dataTableTheme, t),
|
|
datePickerTheme: DatePickerThemeData.lerp(a.datePickerTheme, b.datePickerTheme, t),
|
|
dialogTheme: DialogThemeData.lerp(a.dialogTheme, b.dialogTheme, t),
|
|
dividerTheme: DividerThemeData.lerp(a.dividerTheme, b.dividerTheme, t),
|
|
drawerTheme: DrawerThemeData.lerp(a.drawerTheme, b.drawerTheme, t)!,
|
|
dropdownMenuTheme: DropdownMenuThemeData.lerp(a.dropdownMenuTheme, b.dropdownMenuTheme, t),
|
|
elevatedButtonTheme:
|
|
ElevatedButtonThemeData.lerp(a.elevatedButtonTheme, b.elevatedButtonTheme, t)!,
|
|
expansionTileTheme:
|
|
ExpansionTileThemeData.lerp(a.expansionTileTheme, b.expansionTileTheme, t)!,
|
|
filledButtonTheme: FilledButtonThemeData.lerp(a.filledButtonTheme, b.filledButtonTheme, t)!,
|
|
floatingActionButtonTheme:
|
|
FloatingActionButtonThemeData.lerp(
|
|
a.floatingActionButtonTheme,
|
|
b.floatingActionButtonTheme,
|
|
t,
|
|
)!,
|
|
iconButtonTheme: IconButtonThemeData.lerp(a.iconButtonTheme, b.iconButtonTheme, t)!,
|
|
listTileTheme: ListTileThemeData.lerp(a.listTileTheme, b.listTileTheme, t)!,
|
|
menuBarTheme: MenuBarThemeData.lerp(a.menuBarTheme, b.menuBarTheme, t)!,
|
|
menuButtonTheme: MenuButtonThemeData.lerp(a.menuButtonTheme, b.menuButtonTheme, t)!,
|
|
menuTheme: MenuThemeData.lerp(a.menuTheme, b.menuTheme, t)!,
|
|
navigationBarTheme:
|
|
NavigationBarThemeData.lerp(a.navigationBarTheme, b.navigationBarTheme, t)!,
|
|
navigationDrawerTheme:
|
|
NavigationDrawerThemeData.lerp(a.navigationDrawerTheme, b.navigationDrawerTheme, t)!,
|
|
navigationRailTheme:
|
|
NavigationRailThemeData.lerp(a.navigationRailTheme, b.navigationRailTheme, t)!,
|
|
outlinedButtonTheme:
|
|
OutlinedButtonThemeData.lerp(a.outlinedButtonTheme, b.outlinedButtonTheme, t)!,
|
|
popupMenuTheme: PopupMenuThemeData.lerp(a.popupMenuTheme, b.popupMenuTheme, t)!,
|
|
progressIndicatorTheme:
|
|
ProgressIndicatorThemeData.lerp(a.progressIndicatorTheme, b.progressIndicatorTheme, t)!,
|
|
radioTheme: RadioThemeData.lerp(a.radioTheme, b.radioTheme, t),
|
|
searchBarTheme: SearchBarThemeData.lerp(a.searchBarTheme, b.searchBarTheme, t)!,
|
|
searchViewTheme: SearchViewThemeData.lerp(a.searchViewTheme, b.searchViewTheme, t)!,
|
|
segmentedButtonTheme: SegmentedButtonThemeData.lerp(
|
|
a.segmentedButtonTheme,
|
|
b.segmentedButtonTheme,
|
|
t,
|
|
),
|
|
sliderTheme: SliderThemeData.lerp(a.sliderTheme, b.sliderTheme, t),
|
|
snackBarTheme: SnackBarThemeData.lerp(a.snackBarTheme, b.snackBarTheme, t),
|
|
switchTheme: SwitchThemeData.lerp(a.switchTheme, b.switchTheme, t),
|
|
tabBarTheme: TabBarThemeData.lerp(a.tabBarTheme, b.tabBarTheme, t),
|
|
textButtonTheme: TextButtonThemeData.lerp(a.textButtonTheme, b.textButtonTheme, t)!,
|
|
textSelectionTheme:
|
|
TextSelectionThemeData.lerp(a.textSelectionTheme, b.textSelectionTheme, t)!,
|
|
timePickerTheme: TimePickerThemeData.lerp(a.timePickerTheme, b.timePickerTheme, t),
|
|
toggleButtonsTheme:
|
|
ToggleButtonsThemeData.lerp(a.toggleButtonsTheme, b.toggleButtonsTheme, t)!,
|
|
tooltipTheme: TooltipThemeData.lerp(a.tooltipTheme, b.tooltipTheme, t)!,
|
|
// DEPRECATED (newest deprecations at the bottom)
|
|
buttonBarTheme: ButtonBarThemeData.lerp(a.buttonBarTheme, b.buttonBarTheme, t),
|
|
dialogBackgroundColor: Color.lerp(a.dialogBackgroundColor, b.dialogBackgroundColor, t)!,
|
|
indicatorColor: Color.lerp(a.indicatorColor, b.indicatorColor, t)!,
|
|
);
|
|
}
|
|
|
|
@override
|
|
bool operator ==(Object other) {
|
|
if (other.runtimeType != runtimeType) {
|
|
return false;
|
|
}
|
|
return other is ThemeData &&
|
|
// For the sanity of the reader, make sure these properties are in the same
|
|
// order in every place that they are separated by section comments (e.g.
|
|
// GENERAL CONFIGURATION). Each section except for deprecations should be
|
|
// alphabetical by symbol name.
|
|
// GENERAL CONFIGURATION
|
|
mapEquals(other.adaptationMap, adaptationMap) &&
|
|
other.applyElevationOverlayColor == applyElevationOverlayColor &&
|
|
other.cupertinoOverrideTheme == cupertinoOverrideTheme &&
|
|
mapEquals(other.extensions, extensions) &&
|
|
other.inputDecorationTheme == inputDecorationTheme &&
|
|
other.materialTapTargetSize == materialTapTargetSize &&
|
|
other.pageTransitionsTheme == pageTransitionsTheme &&
|
|
other.platform == platform &&
|
|
other.scrollbarTheme == scrollbarTheme &&
|
|
other.splashFactory == splashFactory &&
|
|
other.useMaterial3 == useMaterial3 &&
|
|
other.visualDensity == visualDensity &&
|
|
// COLOR
|
|
other.canvasColor == canvasColor &&
|
|
other.cardColor == cardColor &&
|
|
other.colorScheme == colorScheme &&
|
|
other.disabledColor == disabledColor &&
|
|
other.dividerColor == dividerColor &&
|
|
other.focusColor == focusColor &&
|
|
other.highlightColor == highlightColor &&
|
|
other.hintColor == hintColor &&
|
|
other.hoverColor == hoverColor &&
|
|
other.primaryColor == primaryColor &&
|
|
other.primaryColorDark == primaryColorDark &&
|
|
other.primaryColorLight == primaryColorLight &&
|
|
other.scaffoldBackgroundColor == scaffoldBackgroundColor &&
|
|
other.secondaryHeaderColor == secondaryHeaderColor &&
|
|
other.shadowColor == shadowColor &&
|
|
other.splashColor == splashColor &&
|
|
other.unselectedWidgetColor == unselectedWidgetColor &&
|
|
// TYPOGRAPHY & ICONOGRAPHY
|
|
other.iconTheme == iconTheme &&
|
|
other.primaryIconTheme == primaryIconTheme &&
|
|
other.primaryTextTheme == primaryTextTheme &&
|
|
other.textTheme == textTheme &&
|
|
other.typography == typography &&
|
|
// COMPONENT THEMES
|
|
other.actionIconTheme == actionIconTheme &&
|
|
other.appBarTheme == appBarTheme &&
|
|
other.badgeTheme == badgeTheme &&
|
|
other.bannerTheme == bannerTheme &&
|
|
other.bottomAppBarTheme == bottomAppBarTheme &&
|
|
other.bottomNavigationBarTheme == bottomNavigationBarTheme &&
|
|
other.bottomSheetTheme == bottomSheetTheme &&
|
|
other.buttonTheme == buttonTheme &&
|
|
other.cardTheme == cardTheme &&
|
|
other.checkboxTheme == checkboxTheme &&
|
|
other.chipTheme == chipTheme &&
|
|
other.dataTableTheme == dataTableTheme &&
|
|
other.datePickerTheme == datePickerTheme &&
|
|
other.dialogTheme == dialogTheme &&
|
|
other.dividerTheme == dividerTheme &&
|
|
other.drawerTheme == drawerTheme &&
|
|
other.dropdownMenuTheme == dropdownMenuTheme &&
|
|
other.elevatedButtonTheme == elevatedButtonTheme &&
|
|
other.expansionTileTheme == expansionTileTheme &&
|
|
other.filledButtonTheme == filledButtonTheme &&
|
|
other.floatingActionButtonTheme == floatingActionButtonTheme &&
|
|
other.iconButtonTheme == iconButtonTheme &&
|
|
other.listTileTheme == listTileTheme &&
|
|
other.menuBarTheme == menuBarTheme &&
|
|
other.menuButtonTheme == menuButtonTheme &&
|
|
other.menuTheme == menuTheme &&
|
|
other.navigationBarTheme == navigationBarTheme &&
|
|
other.navigationDrawerTheme == navigationDrawerTheme &&
|
|
other.navigationRailTheme == navigationRailTheme &&
|
|
other.outlinedButtonTheme == outlinedButtonTheme &&
|
|
other.popupMenuTheme == popupMenuTheme &&
|
|
other.progressIndicatorTheme == progressIndicatorTheme &&
|
|
other.radioTheme == radioTheme &&
|
|
other.searchBarTheme == searchBarTheme &&
|
|
other.searchViewTheme == searchViewTheme &&
|
|
other.segmentedButtonTheme == segmentedButtonTheme &&
|
|
other.sliderTheme == sliderTheme &&
|
|
other.snackBarTheme == snackBarTheme &&
|
|
other.switchTheme == switchTheme &&
|
|
other.tabBarTheme == tabBarTheme &&
|
|
other.textButtonTheme == textButtonTheme &&
|
|
other.textSelectionTheme == textSelectionTheme &&
|
|
other.timePickerTheme == timePickerTheme &&
|
|
other.toggleButtonsTheme == toggleButtonsTheme &&
|
|
other.tooltipTheme == tooltipTheme &&
|
|
// DEPRECATED (newest deprecations at the bottom)
|
|
other.buttonBarTheme == buttonBarTheme &&
|
|
other.dialogBackgroundColor == dialogBackgroundColor &&
|
|
other.indicatorColor == indicatorColor;
|
|
}
|
|
|
|
@override
|
|
int get hashCode {
|
|
final List<Object?> values = <Object?>[
|
|
// For the sanity of the reader, make sure these properties are in the same
|
|
// order in every place that they are separated by section comments (e.g.
|
|
// GENERAL CONFIGURATION). Each section except for deprecations should be
|
|
// alphabetical by symbol name.
|
|
|
|
// GENERAL CONFIGURATION
|
|
...adaptationMap.keys,
|
|
...adaptationMap.values,
|
|
applyElevationOverlayColor,
|
|
cupertinoOverrideTheme,
|
|
...extensions.keys,
|
|
...extensions.values,
|
|
inputDecorationTheme,
|
|
materialTapTargetSize,
|
|
pageTransitionsTheme,
|
|
platform,
|
|
scrollbarTheme,
|
|
splashFactory,
|
|
useMaterial3,
|
|
visualDensity,
|
|
// COLOR
|
|
canvasColor,
|
|
cardColor,
|
|
colorScheme,
|
|
disabledColor,
|
|
dividerColor,
|
|
focusColor,
|
|
highlightColor,
|
|
hintColor,
|
|
hoverColor,
|
|
primaryColor,
|
|
primaryColorDark,
|
|
primaryColorLight,
|
|
scaffoldBackgroundColor,
|
|
secondaryHeaderColor,
|
|
shadowColor,
|
|
splashColor,
|
|
unselectedWidgetColor,
|
|
// TYPOGRAPHY & ICONOGRAPHY
|
|
iconTheme,
|
|
primaryIconTheme,
|
|
primaryTextTheme,
|
|
textTheme,
|
|
typography,
|
|
// COMPONENT THEMES
|
|
actionIconTheme,
|
|
appBarTheme,
|
|
badgeTheme,
|
|
bannerTheme,
|
|
bottomAppBarTheme,
|
|
bottomNavigationBarTheme,
|
|
bottomSheetTheme,
|
|
buttonTheme,
|
|
cardTheme,
|
|
checkboxTheme,
|
|
chipTheme,
|
|
dataTableTheme,
|
|
datePickerTheme,
|
|
dialogTheme,
|
|
dividerTheme,
|
|
drawerTheme,
|
|
dropdownMenuTheme,
|
|
elevatedButtonTheme,
|
|
expansionTileTheme,
|
|
filledButtonTheme,
|
|
floatingActionButtonTheme,
|
|
iconButtonTheme,
|
|
listTileTheme,
|
|
menuBarTheme,
|
|
menuButtonTheme,
|
|
menuTheme,
|
|
navigationBarTheme,
|
|
navigationDrawerTheme,
|
|
navigationRailTheme,
|
|
outlinedButtonTheme,
|
|
popupMenuTheme,
|
|
progressIndicatorTheme,
|
|
radioTheme,
|
|
searchBarTheme,
|
|
searchViewTheme,
|
|
segmentedButtonTheme,
|
|
sliderTheme,
|
|
snackBarTheme,
|
|
switchTheme,
|
|
tabBarTheme,
|
|
textButtonTheme,
|
|
textSelectionTheme,
|
|
timePickerTheme,
|
|
toggleButtonsTheme,
|
|
tooltipTheme,
|
|
// DEPRECATED (newest deprecations at the bottom)
|
|
buttonBarTheme,
|
|
dialogBackgroundColor,
|
|
indicatorColor,
|
|
];
|
|
return Object.hashAll(values);
|
|
}
|
|
|
|
@override
|
|
void debugFillProperties(DiagnosticPropertiesBuilder properties) {
|
|
super.debugFillProperties(properties);
|
|
final ThemeData defaultData = ThemeData.fallback();
|
|
// For the sanity of the reader, make sure these properties are in the same
|
|
// order in every place that they are separated by section comments (e.g.
|
|
// GENERAL CONFIGURATION). Each section except for deprecations should be
|
|
// alphabetical by symbol name.
|
|
|
|
// GENERAL CONFIGURATION
|
|
properties.add(
|
|
IterableProperty<Adaptation<dynamic>>(
|
|
'adaptations',
|
|
adaptationMap.values,
|
|
defaultValue: defaultData.adaptationMap.values,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<bool>(
|
|
'applyElevationOverlayColor',
|
|
applyElevationOverlayColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<NoDefaultCupertinoThemeData>(
|
|
'cupertinoOverrideTheme',
|
|
cupertinoOverrideTheme,
|
|
defaultValue: defaultData.cupertinoOverrideTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
IterableProperty<ThemeExtension<dynamic>>(
|
|
'extensions',
|
|
extensions.values,
|
|
defaultValue: defaultData.extensions.values,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<InputDecorationTheme>(
|
|
'inputDecorationTheme',
|
|
inputDecorationTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<MaterialTapTargetSize>(
|
|
'materialTapTargetSize',
|
|
materialTapTargetSize,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<PageTransitionsTheme>(
|
|
'pageTransitionsTheme',
|
|
pageTransitionsTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
EnumProperty<TargetPlatform>(
|
|
'platform',
|
|
platform,
|
|
defaultValue: defaultTargetPlatform,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<ScrollbarThemeData>(
|
|
'scrollbarTheme',
|
|
scrollbarTheme,
|
|
defaultValue: defaultData.scrollbarTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<InteractiveInkFeatureFactory>(
|
|
'splashFactory',
|
|
splashFactory,
|
|
defaultValue: defaultData.splashFactory,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<bool>(
|
|
'useMaterial3',
|
|
useMaterial3,
|
|
defaultValue: defaultData.useMaterial3,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<VisualDensity>(
|
|
'visualDensity',
|
|
visualDensity,
|
|
defaultValue: defaultData.visualDensity,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
// COLORS
|
|
properties.add(
|
|
ColorProperty(
|
|
'canvasColor',
|
|
canvasColor,
|
|
defaultValue: defaultData.canvasColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'cardColor',
|
|
cardColor,
|
|
defaultValue: defaultData.cardColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<ColorScheme>(
|
|
'colorScheme',
|
|
colorScheme,
|
|
defaultValue: defaultData.colorScheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'disabledColor',
|
|
disabledColor,
|
|
defaultValue: defaultData.disabledColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'dividerColor',
|
|
dividerColor,
|
|
defaultValue: defaultData.dividerColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'focusColor',
|
|
focusColor,
|
|
defaultValue: defaultData.focusColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'highlightColor',
|
|
highlightColor,
|
|
defaultValue: defaultData.highlightColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'hintColor',
|
|
hintColor,
|
|
defaultValue: defaultData.hintColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'hoverColor',
|
|
hoverColor,
|
|
defaultValue: defaultData.hoverColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'primaryColorDark',
|
|
primaryColorDark,
|
|
defaultValue: defaultData.primaryColorDark,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'primaryColorLight',
|
|
primaryColorLight,
|
|
defaultValue: defaultData.primaryColorLight,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'primaryColor',
|
|
primaryColor,
|
|
defaultValue: defaultData.primaryColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'scaffoldBackgroundColor',
|
|
scaffoldBackgroundColor,
|
|
defaultValue: defaultData.scaffoldBackgroundColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'secondaryHeaderColor',
|
|
secondaryHeaderColor,
|
|
defaultValue: defaultData.secondaryHeaderColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'shadowColor',
|
|
shadowColor,
|
|
defaultValue: defaultData.shadowColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'splashColor',
|
|
splashColor,
|
|
defaultValue: defaultData.splashColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'unselectedWidgetColor',
|
|
unselectedWidgetColor,
|
|
defaultValue: defaultData.unselectedWidgetColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
// TYPOGRAPHY & ICONOGRAPHY
|
|
properties.add(
|
|
DiagnosticsProperty<IconThemeData>('iconTheme', iconTheme, level: DiagnosticLevel.debug),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<IconThemeData>(
|
|
'primaryIconTheme',
|
|
primaryIconTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<TextTheme>(
|
|
'primaryTextTheme',
|
|
primaryTextTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<TextTheme>('textTheme', textTheme, level: DiagnosticLevel.debug),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<Typography>(
|
|
'typography',
|
|
typography,
|
|
defaultValue: defaultData.typography,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
// COMPONENT THEMES
|
|
properties.add(
|
|
DiagnosticsProperty<ActionIconThemeData>(
|
|
'actionIconTheme',
|
|
actionIconTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<AppBarTheme>(
|
|
'appBarTheme',
|
|
appBarTheme,
|
|
defaultValue: defaultData.appBarTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<BadgeThemeData>(
|
|
'badgeTheme',
|
|
badgeTheme,
|
|
defaultValue: defaultData.badgeTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<MaterialBannerThemeData>(
|
|
'bannerTheme',
|
|
bannerTheme,
|
|
defaultValue: defaultData.bannerTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<BottomAppBarTheme>(
|
|
'bottomAppBarTheme',
|
|
bottomAppBarTheme,
|
|
defaultValue: defaultData.bottomAppBarTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<BottomNavigationBarThemeData>(
|
|
'bottomNavigationBarTheme',
|
|
bottomNavigationBarTheme,
|
|
defaultValue: defaultData.bottomNavigationBarTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<BottomSheetThemeData>(
|
|
'bottomSheetTheme',
|
|
bottomSheetTheme,
|
|
defaultValue: defaultData.bottomSheetTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<ButtonThemeData>(
|
|
'buttonTheme',
|
|
buttonTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<CardThemeData>('cardTheme', cardTheme, level: DiagnosticLevel.debug),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<CheckboxThemeData>(
|
|
'checkboxTheme',
|
|
checkboxTheme,
|
|
defaultValue: defaultData.checkboxTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<ChipThemeData>('chipTheme', chipTheme, level: DiagnosticLevel.debug),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<DataTableThemeData>(
|
|
'dataTableTheme',
|
|
dataTableTheme,
|
|
defaultValue: defaultData.dataTableTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<DatePickerThemeData>(
|
|
'datePickerTheme',
|
|
datePickerTheme,
|
|
defaultValue: defaultData.datePickerTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<DialogThemeData>(
|
|
'dialogTheme',
|
|
dialogTheme,
|
|
defaultValue: defaultData.dialogTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<DividerThemeData>(
|
|
'dividerTheme',
|
|
dividerTheme,
|
|
defaultValue: defaultData.dividerTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<DrawerThemeData>(
|
|
'drawerTheme',
|
|
drawerTheme,
|
|
defaultValue: defaultData.drawerTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<DropdownMenuThemeData>(
|
|
'dropdownMenuTheme',
|
|
dropdownMenuTheme,
|
|
defaultValue: defaultData.dropdownMenuTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<ElevatedButtonThemeData>(
|
|
'elevatedButtonTheme',
|
|
elevatedButtonTheme,
|
|
defaultValue: defaultData.elevatedButtonTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<ExpansionTileThemeData>(
|
|
'expansionTileTheme',
|
|
expansionTileTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<FilledButtonThemeData>(
|
|
'filledButtonTheme',
|
|
filledButtonTheme,
|
|
defaultValue: defaultData.filledButtonTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<FloatingActionButtonThemeData>(
|
|
'floatingActionButtonTheme',
|
|
floatingActionButtonTheme,
|
|
defaultValue: defaultData.floatingActionButtonTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<IconButtonThemeData>(
|
|
'iconButtonTheme',
|
|
iconButtonTheme,
|
|
defaultValue: defaultData.iconButtonTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<ListTileThemeData>(
|
|
'listTileTheme',
|
|
listTileTheme,
|
|
defaultValue: defaultData.listTileTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<MenuBarThemeData>(
|
|
'menuBarTheme',
|
|
menuBarTheme,
|
|
defaultValue: defaultData.menuBarTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<MenuButtonThemeData>(
|
|
'menuButtonTheme',
|
|
menuButtonTheme,
|
|
defaultValue: defaultData.menuButtonTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<MenuThemeData>(
|
|
'menuTheme',
|
|
menuTheme,
|
|
defaultValue: defaultData.menuTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<NavigationBarThemeData>(
|
|
'navigationBarTheme',
|
|
navigationBarTheme,
|
|
defaultValue: defaultData.navigationBarTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<NavigationDrawerThemeData>(
|
|
'navigationDrawerTheme',
|
|
navigationDrawerTheme,
|
|
defaultValue: defaultData.navigationDrawerTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<NavigationRailThemeData>(
|
|
'navigationRailTheme',
|
|
navigationRailTheme,
|
|
defaultValue: defaultData.navigationRailTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<OutlinedButtonThemeData>(
|
|
'outlinedButtonTheme',
|
|
outlinedButtonTheme,
|
|
defaultValue: defaultData.outlinedButtonTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<PopupMenuThemeData>(
|
|
'popupMenuTheme',
|
|
popupMenuTheme,
|
|
defaultValue: defaultData.popupMenuTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<ProgressIndicatorThemeData>(
|
|
'progressIndicatorTheme',
|
|
progressIndicatorTheme,
|
|
defaultValue: defaultData.progressIndicatorTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<RadioThemeData>(
|
|
'radioTheme',
|
|
radioTheme,
|
|
defaultValue: defaultData.radioTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<SearchBarThemeData>(
|
|
'searchBarTheme',
|
|
searchBarTheme,
|
|
defaultValue: defaultData.searchBarTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<SearchViewThemeData>(
|
|
'searchViewTheme',
|
|
searchViewTheme,
|
|
defaultValue: defaultData.searchViewTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<SegmentedButtonThemeData>(
|
|
'segmentedButtonTheme',
|
|
segmentedButtonTheme,
|
|
defaultValue: defaultData.segmentedButtonTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<SliderThemeData>(
|
|
'sliderTheme',
|
|
sliderTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<SnackBarThemeData>(
|
|
'snackBarTheme',
|
|
snackBarTheme,
|
|
defaultValue: defaultData.snackBarTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<SwitchThemeData>(
|
|
'switchTheme',
|
|
switchTheme,
|
|
defaultValue: defaultData.switchTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<TabBarThemeData>(
|
|
'tabBarTheme',
|
|
tabBarTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<TextButtonThemeData>(
|
|
'textButtonTheme',
|
|
textButtonTheme,
|
|
defaultValue: defaultData.textButtonTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<TextSelectionThemeData>(
|
|
'textSelectionTheme',
|
|
textSelectionTheme,
|
|
defaultValue: defaultData.textSelectionTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<TimePickerThemeData>(
|
|
'timePickerTheme',
|
|
timePickerTheme,
|
|
defaultValue: defaultData.timePickerTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<ToggleButtonsThemeData>(
|
|
'toggleButtonsTheme',
|
|
toggleButtonsTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
DiagnosticsProperty<TooltipThemeData>(
|
|
'tooltipTheme',
|
|
tooltipTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
// DEPRECATED (newest deprecations at the bottom)
|
|
properties.add(
|
|
DiagnosticsProperty<ButtonBarThemeData>(
|
|
'buttonBarTheme',
|
|
buttonBarTheme,
|
|
defaultValue: defaultData.buttonBarTheme,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'dialogBackgroundColor',
|
|
dialogBackgroundColor,
|
|
defaultValue: defaultData.dialogBackgroundColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
properties.add(
|
|
ColorProperty(
|
|
'indicatorColor',
|
|
indicatorColor,
|
|
defaultValue: defaultData.indicatorColor,
|
|
level: DiagnosticLevel.debug,
|
|
),
|
|
);
|
|
}
|
|
}
|
|
|
|
/// A [CupertinoThemeData] that defers unspecified theme attributes to an
|
|
/// upstream Material [ThemeData].
|
|
///
|
|
/// This type of [CupertinoThemeData] is used by the Material [Theme] to
|
|
/// harmonize the [CupertinoTheme] with the material theme's colors and text
|
|
/// styles.
|
|
///
|
|
/// In the most basic case, [ThemeData]'s `cupertinoOverrideTheme` is null and
|
|
/// descendant Cupertino widgets' styling is derived from the Material theme.
|
|
///
|
|
/// To override individual parts of the Material-derived Cupertino styling,
|
|
/// `cupertinoOverrideTheme`'s construction parameters can be used.
|
|
///
|
|
/// To completely decouple the Cupertino styling from Material theme derivation,
|
|
/// another [CupertinoTheme] widget can be inserted as a descendant of the
|
|
/// Material [Theme]. On a [MaterialApp], this can be done using the `builder`
|
|
/// parameter on the constructor.
|
|
///
|
|
/// See also:
|
|
///
|
|
/// * [CupertinoThemeData], whose null constructor parameters default to
|
|
/// reasonable iOS styling defaults rather than harmonizing with a Material
|
|
/// theme.
|
|
/// * [Theme], widget which inserts a [CupertinoTheme] with this
|
|
/// [MaterialBasedCupertinoThemeData].
|
|
// This class subclasses CupertinoThemeData rather than composes one because it
|
|
// _is_ a CupertinoThemeData with partially altered behavior. e.g. its textTheme
|
|
// is from the superclass and based on the primaryColor but the primaryColor
|
|
// comes from the Material theme unless overridden.
|
|
class MaterialBasedCupertinoThemeData extends CupertinoThemeData {
|
|
/// Create a [MaterialBasedCupertinoThemeData] based on a Material [ThemeData]
|
|
/// and its `cupertinoOverrideTheme`.
|
|
MaterialBasedCupertinoThemeData({required ThemeData materialTheme})
|
|
: this._(
|
|
materialTheme,
|
|
(materialTheme.cupertinoOverrideTheme ?? const CupertinoThemeData()).noDefault(),
|
|
);
|
|
|
|
MaterialBasedCupertinoThemeData._(this._materialTheme, this._cupertinoOverrideTheme)
|
|
: // Pass all values to the superclass so Material-agnostic properties
|
|
// like barBackgroundColor can still behave like a normal
|
|
// CupertinoThemeData.
|
|
super.raw(
|
|
_cupertinoOverrideTheme.brightness,
|
|
_cupertinoOverrideTheme.primaryColor,
|
|
_cupertinoOverrideTheme.primaryContrastingColor,
|
|
_cupertinoOverrideTheme.textTheme,
|
|
_cupertinoOverrideTheme.barBackgroundColor,
|
|
_cupertinoOverrideTheme.scaffoldBackgroundColor,
|
|
_cupertinoOverrideTheme.applyThemeToAll,
|
|
);
|
|
|
|
final ThemeData _materialTheme;
|
|
final NoDefaultCupertinoThemeData _cupertinoOverrideTheme;
|
|
|
|
@override
|
|
Brightness get brightness => _cupertinoOverrideTheme.brightness ?? _materialTheme.brightness;
|
|
|
|
@override
|
|
Color get primaryColor =>
|
|
_cupertinoOverrideTheme.primaryColor ?? _materialTheme.colorScheme.primary;
|
|
|
|
@override
|
|
Color get primaryContrastingColor =>
|
|
_cupertinoOverrideTheme.primaryContrastingColor ?? _materialTheme.colorScheme.onPrimary;
|
|
|
|
@override
|
|
Color get scaffoldBackgroundColor =>
|
|
_cupertinoOverrideTheme.scaffoldBackgroundColor ?? _materialTheme.scaffoldBackgroundColor;
|
|
|
|
/// Copies the [ThemeData]'s `cupertinoOverrideTheme`.
|
|
///
|
|
/// Only the specified override attributes of the [ThemeData]'s
|
|
/// `cupertinoOverrideTheme` and the newly specified parameters are in the
|
|
/// returned [CupertinoThemeData]. No derived attributes from iOS defaults or
|
|
/// from cascaded Material theme attributes are copied.
|
|
///
|
|
/// This [copyWith] cannot change the base Material [ThemeData]. To change the
|
|
/// base Material [ThemeData], create a new Material [Theme] and use
|
|
/// [ThemeData.copyWith] on the Material [ThemeData] instead.
|
|
@override
|
|
MaterialBasedCupertinoThemeData copyWith({
|
|
Brightness? brightness,
|
|
Color? primaryColor,
|
|
Color? primaryContrastingColor,
|
|
CupertinoTextThemeData? textTheme,
|
|
Color? barBackgroundColor,
|
|
Color? scaffoldBackgroundColor,
|
|
bool? applyThemeToAll,
|
|
}) {
|
|
return MaterialBasedCupertinoThemeData._(
|
|
_materialTheme,
|
|
_cupertinoOverrideTheme.copyWith(
|
|
brightness: brightness,
|
|
primaryColor: primaryColor,
|
|
primaryContrastingColor: primaryContrastingColor,
|
|
textTheme: textTheme,
|
|
barBackgroundColor: barBackgroundColor,
|
|
scaffoldBackgroundColor: scaffoldBackgroundColor,
|
|
applyThemeToAll: applyThemeToAll,
|
|
),
|
|
);
|
|
}
|
|
|
|
@override
|
|
CupertinoThemeData resolveFrom(BuildContext context) {
|
|
// Only the cupertino override theme part will be resolved.
|
|
// If the color comes from the material theme it's not resolved.
|
|
return MaterialBasedCupertinoThemeData._(
|
|
_materialTheme,
|
|
_cupertinoOverrideTheme.resolveFrom(context),
|
|
);
|
|
}
|
|
}
|
|
|
|
/// A class for creating a Material theme with a color scheme based off of the
|
|
/// colors from a [CupertinoThemeData]. This is intended to be used only in the
|
|
/// case when a Material widget is unable to find a Material theme in the tree,
|
|
/// but is able to find a Cupertino theme. Most often this will occur when a
|
|
/// Material widget is used inside of a [CupertinoApp].
|
|
///
|
|
/// Besides the colors, this theme will use all the defaults from Material's
|
|
/// [ThemeData], so if further customization is needed, it is best to manually
|
|
/// add a Material [Theme] above the [CupertinoApp].
|
|
class CupertinoBasedMaterialThemeData {
|
|
/// Creates a Material theme with a color scheme based off of the colors from
|
|
/// a [CupertinoThemeData].
|
|
CupertinoBasedMaterialThemeData({required CupertinoThemeData themeData})
|
|
: materialTheme = ThemeData(
|
|
colorScheme: ColorScheme.fromSeed(
|
|
seedColor: themeData.primaryColor,
|
|
brightness: themeData.brightness ?? Brightness.light,
|
|
primary: themeData.primaryColor,
|
|
onPrimary: themeData.primaryContrastingColor,
|
|
),
|
|
);
|
|
|
|
/// The Material theme data with colors based on an existing [CupertinoThemeData].
|
|
final ThemeData materialTheme;
|
|
}
|
|
|
|
@immutable
|
|
class _IdentityThemeDataCacheKey {
|
|
const _IdentityThemeDataCacheKey(this.baseTheme, this.localTextGeometry);
|
|
|
|
final ThemeData baseTheme;
|
|
final TextTheme localTextGeometry;
|
|
|
|
// Using XOR to make the hash function as fast as possible (e.g. Jenkins is
|
|
// noticeably slower).
|
|
@override
|
|
int get hashCode => identityHashCode(baseTheme) ^ identityHashCode(localTextGeometry);
|
|
|
|
@override
|
|
bool operator ==(Object other) {
|
|
// We are explicitly ignoring the possibility that the types might not
|
|
// match in the interests of speed.
|
|
return other is _IdentityThemeDataCacheKey &&
|
|
identical(other.baseTheme, baseTheme) &&
|
|
identical(other.localTextGeometry, localTextGeometry);
|
|
}
|
|
}
|
|
|
|
/// Cache of objects of limited size that uses the first in first out eviction
|
|
/// strategy (a.k.a least recently inserted).
|
|
///
|
|
/// The key that was inserted before all other keys is evicted first, i.e. the
|
|
/// one inserted least recently.
|
|
class _FifoCache<K, V> {
|
|
_FifoCache(this._maximumSize) : assert(_maximumSize > 0);
|
|
|
|
/// In Dart the map literal uses a linked hash-map implementation, whose keys
|
|
/// are stored such that [Map.keys] returns them in the order they were
|
|
/// inserted.
|
|
final Map<K, V> _cache = <K, V>{};
|
|
|
|
/// Maximum number of entries to store in the cache.
|
|
///
|
|
/// Once this many entries have been cached, the entry inserted least recently
|
|
/// is evicted when adding a new entry.
|
|
final int _maximumSize;
|
|
|
|
/// Returns the previously cached value for the given key, if available;
|
|
/// if not, calls the given callback to obtain it first.
|
|
V putIfAbsent(K key, V Function() loader) {
|
|
assert(key != null);
|
|
final V? result = _cache[key];
|
|
if (result != null) {
|
|
return result;
|
|
}
|
|
if (_cache.length == _maximumSize) {
|
|
_cache.remove(_cache.keys.first);
|
|
}
|
|
return _cache[key] = loader();
|
|
}
|
|
}
|
|
|
|
/// Defines the visual density of user interface components.
|
|
///
|
|
/// Density, in the context of a UI, is the vertical and horizontal
|
|
/// "compactness" of the components in the UI. It is unitless, since it means
|
|
/// different things to different UI components.
|
|
///
|
|
/// The default for visual densities is zero for both vertical and horizontal
|
|
/// densities, which corresponds to the default visual density of components in
|
|
/// the Material Design specification. It does not affect text sizes, icon
|
|
/// sizes, or padding values.
|
|
///
|
|
/// For example, for buttons, it affects the spacing around the child of the
|
|
/// button. For lists, it affects the distance between baselines of entries in
|
|
/// the list. For chips, it only affects the vertical size, not the horizontal
|
|
/// size.
|
|
///
|
|
/// Here are some examples of widgets that respond to density changes:
|
|
///
|
|
/// * [Checkbox]
|
|
/// * [Chip]
|
|
/// * [ElevatedButton]
|
|
/// * [IconButton]
|
|
/// * [InputDecorator] (which gives density support to [TextField], etc.)
|
|
/// * [ListTile]
|
|
/// * [MaterialButton]
|
|
/// * [OutlinedButton]
|
|
/// * [Radio]
|
|
/// * [RawMaterialButton]
|
|
/// * [TextButton]
|
|
///
|
|
/// See also:
|
|
///
|
|
/// * [ThemeData.visualDensity], where this property is used to specify the base
|
|
/// horizontal density of Material components.
|
|
/// * [Material design guidance on density](https://material.io/design/layout/applying-density.html).
|
|
@immutable
|
|
class VisualDensity with Diagnosticable {
|
|
/// A const constructor for [VisualDensity].
|
|
///
|
|
/// The [horizontal] and [vertical] arguments must be in the interval between
|
|
/// [minimumDensity] and [maximumDensity], inclusive.
|
|
const VisualDensity({this.horizontal = 0.0, this.vertical = 0.0})
|
|
: assert(vertical <= maximumDensity),
|
|
assert(vertical >= minimumDensity),
|
|
assert(horizontal <= maximumDensity),
|
|
assert(horizontal >= minimumDensity);
|
|
|
|
/// The minimum allowed density.
|
|
static const double minimumDensity = -4.0;
|
|
|
|
/// The maximum allowed density.
|
|
static const double maximumDensity = 4.0;
|
|
|
|
/// The default profile for [VisualDensity] in [ThemeData].
|
|
///
|
|
/// This default value represents a visual density that is less dense than
|
|
/// either [comfortable] or [compact], and corresponds to density values of
|
|
/// zero in both axes.
|
|
static const VisualDensity standard = VisualDensity();
|
|
|
|
/// The profile for a "comfortable" interpretation of [VisualDensity].
|
|
///
|
|
/// Individual components will interpret the density value independently,
|
|
/// making themselves more visually dense than [standard] and less dense than
|
|
/// [compact] to different degrees based on the Material Design specification
|
|
/// of the "comfortable" setting for their particular use case.
|
|
///
|
|
/// It corresponds to a density value of -1 in both axes.
|
|
static const VisualDensity comfortable = VisualDensity(horizontal: -1.0, vertical: -1.0);
|
|
|
|
/// The profile for a "compact" interpretation of [VisualDensity].
|
|
///
|
|
/// Individual components will interpret the density value independently,
|
|
/// making themselves more visually dense than [standard] and [comfortable] to
|
|
/// different degrees based on the Material Design specification of the
|
|
/// "comfortable" setting for their particular use case.
|
|
///
|
|
/// It corresponds to a density value of -2 in both axes.
|
|
static const VisualDensity compact = VisualDensity(horizontal: -2.0, vertical: -2.0);
|
|
|
|
/// Returns a [VisualDensity] that is adaptive based on the current platform
|
|
/// on which the framework is executing, from [defaultTargetPlatform].
|
|
///
|
|
/// When [defaultTargetPlatform] is a desktop platform, this returns
|
|
/// [compact], and for other platforms, it returns a default-constructed
|
|
/// [VisualDensity].
|
|
///
|
|
/// See also:
|
|
///
|
|
/// * [defaultDensityForPlatform] which returns a [VisualDensity] that is
|
|
/// adaptive based on the platform given to it.
|
|
/// * [defaultTargetPlatform] which returns the platform on which the
|
|
/// framework is currently executing.
|
|
static VisualDensity get adaptivePlatformDensity =>
|
|
defaultDensityForPlatform(defaultTargetPlatform);
|
|
|
|
/// Returns a [VisualDensity] that is adaptive based on the given [platform].
|
|
///
|
|
/// For desktop platforms, this returns [compact], and for other platforms, it
|
|
/// returns a default-constructed [VisualDensity].
|
|
///
|
|
/// See also:
|
|
///
|
|
/// * [adaptivePlatformDensity] which returns a [VisualDensity] that is
|
|
/// adaptive based on [defaultTargetPlatform].
|
|
static VisualDensity defaultDensityForPlatform(TargetPlatform platform) {
|
|
return switch (platform) {
|
|
TargetPlatform.android || TargetPlatform.iOS || TargetPlatform.fuchsia => standard,
|
|
TargetPlatform.linux || TargetPlatform.macOS || TargetPlatform.windows => compact,
|
|
};
|
|
}
|
|
|
|
/// Copy the current [VisualDensity] with the given values replacing the
|
|
/// current values.
|
|
VisualDensity copyWith({double? horizontal, double? vertical}) {
|
|
return VisualDensity(
|
|
horizontal: horizontal ?? this.horizontal,
|
|
vertical: vertical ?? this.vertical,
|
|
);
|
|
}
|
|
|
|
/// The horizontal visual density of UI components.
|
|
///
|
|
/// This property affects only the horizontal spacing between and within
|
|
/// components, to allow for different UI visual densities. It does not affect
|
|
/// text sizes, icon sizes, or padding values. The default value is 0.0,
|
|
/// corresponding to the metrics specified in the Material Design
|
|
/// specification. The value can range from [minimumDensity] to
|
|
/// [maximumDensity], inclusive.
|
|
///
|
|
/// See also:
|
|
///
|
|
/// * [ThemeData.visualDensity], where this property is used to specify the base
|
|
/// horizontal density of Material components.
|
|
/// * [Material design guidance on density](https://material.io/design/layout/applying-density.html).
|
|
final double horizontal;
|
|
|
|
/// The vertical visual density of UI components.
|
|
///
|
|
/// This property affects only the vertical spacing between and within
|
|
/// components, to allow for different UI visual densities. It does not affect
|
|
/// text sizes, icon sizes, or padding values. The default value is 0.0,
|
|
/// corresponding to the metrics specified in the Material Design
|
|
/// specification. The value can range from [minimumDensity] to
|
|
/// [maximumDensity], inclusive.
|
|
///
|
|
/// See also:
|
|
///
|
|
/// * [ThemeData.visualDensity], where this property is used to specify the base
|
|
/// vertical density of Material components.
|
|
/// * [Material design guidance on density](https://material.io/design/layout/applying-density.html).
|
|
final double vertical;
|
|
|
|
/// The base adjustment in logical pixels of the visual density of UI components.
|
|
///
|
|
/// The input density values are multiplied by a constant to arrive at a base
|
|
/// size adjustment that fits Material Design guidelines.
|
|
///
|
|
/// Individual components may adjust this value based upon their own
|
|
/// individual interpretation of density.
|
|
Offset get baseSizeAdjustment {
|
|
// The number of logical pixels represented by an increase or decrease in
|
|
// density by one. The Material Design guidelines say to increment/decrement
|
|
// sizes in terms of four pixel increments.
|
|
const double interval = 4.0;
|
|
|
|
return Offset(horizontal, vertical) * interval;
|
|
}
|
|
|
|
/// Linearly interpolate between two densities.
|
|
static VisualDensity lerp(VisualDensity a, VisualDensity b, double t) {
|
|
if (identical(a, b)) {
|
|
return a;
|
|
}
|
|
return VisualDensity(
|
|
horizontal: lerpDouble(a.horizontal, b.horizontal, t)!,
|
|
vertical: lerpDouble(a.vertical, b.vertical, t)!,
|
|
);
|
|
}
|
|
|
|
/// Return a copy of [constraints] whose minimum width and height have been
|
|
/// updated with the [baseSizeAdjustment].
|
|
///
|
|
/// The resulting minWidth and minHeight values are clamped to not exceed the
|
|
/// maxWidth and maxHeight values, respectively.
|
|
BoxConstraints effectiveConstraints(BoxConstraints constraints) {
|
|
assert(constraints.debugAssertIsValid());
|
|
return constraints.copyWith(
|
|
minWidth: clampDouble(
|
|
constraints.minWidth + baseSizeAdjustment.dx,
|
|
0.0,
|
|
constraints.maxWidth,
|
|
),
|
|
minHeight: clampDouble(
|
|
constraints.minHeight + baseSizeAdjustment.dy,
|
|
0.0,
|
|
constraints.maxHeight,
|
|
),
|
|
);
|
|
}
|
|
|
|
@override
|
|
bool operator ==(Object other) {
|
|
if (other.runtimeType != runtimeType) {
|
|
return false;
|
|
}
|
|
return other is VisualDensity && other.horizontal == horizontal && other.vertical == vertical;
|
|
}
|
|
|
|
@override
|
|
int get hashCode => Object.hash(horizontal, vertical);
|
|
|
|
@override
|
|
void debugFillProperties(DiagnosticPropertiesBuilder properties) {
|
|
super.debugFillProperties(properties);
|
|
properties.add(DoubleProperty('horizontal', horizontal, defaultValue: 0.0));
|
|
properties.add(DoubleProperty('vertical', vertical, defaultValue: 0.0));
|
|
}
|
|
|
|
@override
|
|
String toStringShort() {
|
|
return '${super.toStringShort()}(h: ${debugFormatDouble(horizontal)}, v: ${debugFormatDouble(vertical)})';
|
|
}
|
|
}
|
|
|
|
// BEGIN GENERATED TOKEN PROPERTIES - ColorScheme
|
|
|
|
// Do not edit by hand. The code between the "BEGIN GENERATED" and
|
|
// "END GENERATED" comments are generated from data in the Material
|
|
// Design token database by the script:
|
|
// dev/tools/gen_defaults/bin/gen_defaults.dart.
|
|
|
|
// dart format off
|
|
const ColorScheme _colorSchemeLightM3 = ColorScheme(
|
|
brightness: Brightness.light,
|
|
primary: Color(0xFF6750A4),
|
|
onPrimary: Color(0xFFFFFFFF),
|
|
primaryContainer: Color(0xFFEADDFF),
|
|
onPrimaryContainer: Color(0xFF4F378B),
|
|
primaryFixed: Color(0xFFEADDFF),
|
|
primaryFixedDim: Color(0xFFD0BCFF),
|
|
onPrimaryFixed: Color(0xFF21005D),
|
|
onPrimaryFixedVariant: Color(0xFF4F378B),
|
|
secondary: Color(0xFF625B71),
|
|
onSecondary: Color(0xFFFFFFFF),
|
|
secondaryContainer: Color(0xFFE8DEF8),
|
|
onSecondaryContainer: Color(0xFF4A4458),
|
|
secondaryFixed: Color(0xFFE8DEF8),
|
|
secondaryFixedDim: Color(0xFFCCC2DC),
|
|
onSecondaryFixed: Color(0xFF1D192B),
|
|
onSecondaryFixedVariant: Color(0xFF4A4458),
|
|
tertiary: Color(0xFF7D5260),
|
|
onTertiary: Color(0xFFFFFFFF),
|
|
tertiaryContainer: Color(0xFFFFD8E4),
|
|
onTertiaryContainer: Color(0xFF633B48),
|
|
tertiaryFixed: Color(0xFFFFD8E4),
|
|
tertiaryFixedDim: Color(0xFFEFB8C8),
|
|
onTertiaryFixed: Color(0xFF31111D),
|
|
onTertiaryFixedVariant: Color(0xFF633B48),
|
|
error: Color(0xFFB3261E),
|
|
onError: Color(0xFFFFFFFF),
|
|
errorContainer: Color(0xFFF9DEDC),
|
|
onErrorContainer: Color(0xFF8C1D18),
|
|
background: Color(0xFFFEF7FF),
|
|
onBackground: Color(0xFF1D1B20),
|
|
surface: Color(0xFFFEF7FF),
|
|
surfaceBright: Color(0xFFFEF7FF),
|
|
surfaceContainerLowest: Color(0xFFFFFFFF),
|
|
surfaceContainerLow: Color(0xFFF7F2FA),
|
|
surfaceContainer: Color(0xFFF3EDF7),
|
|
surfaceContainerHigh: Color(0xFFECE6F0),
|
|
surfaceContainerHighest: Color(0xFFE6E0E9),
|
|
surfaceDim: Color(0xFFDED8E1),
|
|
onSurface: Color(0xFF1D1B20),
|
|
surfaceVariant: Color(0xFFE7E0EC),
|
|
onSurfaceVariant: Color(0xFF49454F),
|
|
outline: Color(0xFF79747E),
|
|
outlineVariant: Color(0xFFCAC4D0),
|
|
shadow: Color(0xFF000000),
|
|
scrim: Color(0xFF000000),
|
|
inverseSurface: Color(0xFF322F35),
|
|
onInverseSurface: Color(0xFFF5EFF7),
|
|
inversePrimary: Color(0xFFD0BCFF),
|
|
// The surfaceTint color is set to the same color as the primary.
|
|
surfaceTint: Color(0xFF6750A4),
|
|
);
|
|
|
|
const ColorScheme _colorSchemeDarkM3 = ColorScheme(
|
|
brightness: Brightness.dark,
|
|
primary: Color(0xFFD0BCFF),
|
|
onPrimary: Color(0xFF381E72),
|
|
primaryContainer: Color(0xFF4F378B),
|
|
onPrimaryContainer: Color(0xFFEADDFF),
|
|
primaryFixed: Color(0xFFEADDFF),
|
|
primaryFixedDim: Color(0xFFD0BCFF),
|
|
onPrimaryFixed: Color(0xFF21005D),
|
|
onPrimaryFixedVariant: Color(0xFF4F378B),
|
|
secondary: Color(0xFFCCC2DC),
|
|
onSecondary: Color(0xFF332D41),
|
|
secondaryContainer: Color(0xFF4A4458),
|
|
onSecondaryContainer: Color(0xFFE8DEF8),
|
|
secondaryFixed: Color(0xFFE8DEF8),
|
|
secondaryFixedDim: Color(0xFFCCC2DC),
|
|
onSecondaryFixed: Color(0xFF1D192B),
|
|
onSecondaryFixedVariant: Color(0xFF4A4458),
|
|
tertiary: Color(0xFFEFB8C8),
|
|
onTertiary: Color(0xFF492532),
|
|
tertiaryContainer: Color(0xFF633B48),
|
|
onTertiaryContainer: Color(0xFFFFD8E4),
|
|
tertiaryFixed: Color(0xFFFFD8E4),
|
|
tertiaryFixedDim: Color(0xFFEFB8C8),
|
|
onTertiaryFixed: Color(0xFF31111D),
|
|
onTertiaryFixedVariant: Color(0xFF633B48),
|
|
error: Color(0xFFF2B8B5),
|
|
onError: Color(0xFF601410),
|
|
errorContainer: Color(0xFF8C1D18),
|
|
onErrorContainer: Color(0xFFF9DEDC),
|
|
background: Color(0xFF141218),
|
|
onBackground: Color(0xFFE6E0E9),
|
|
surface: Color(0xFF141218),
|
|
surfaceBright: Color(0xFF3B383E),
|
|
surfaceContainerLowest: Color(0xFF0F0D13),
|
|
surfaceContainerLow: Color(0xFF1D1B20),
|
|
surfaceContainer: Color(0xFF211F26),
|
|
surfaceContainerHigh: Color(0xFF2B2930),
|
|
surfaceContainerHighest: Color(0xFF36343B),
|
|
surfaceDim: Color(0xFF141218),
|
|
onSurface: Color(0xFFE6E0E9),
|
|
surfaceVariant: Color(0xFF49454F),
|
|
onSurfaceVariant: Color(0xFFCAC4D0),
|
|
outline: Color(0xFF938F99),
|
|
outlineVariant: Color(0xFF49454F),
|
|
shadow: Color(0xFF000000),
|
|
scrim: Color(0xFF000000),
|
|
inverseSurface: Color(0xFFE6E0E9),
|
|
onInverseSurface: Color(0xFF322F35),
|
|
inversePrimary: Color(0xFF6750A4),
|
|
// The surfaceTint color is set to the same color as the primary.
|
|
surfaceTint: Color(0xFFD0BCFF),
|
|
);
|
|
// dart format on
|
|
|
|
// END GENERATED TOKEN PROPERTIES - ColorScheme
|