defaultStyleOf method

@override ButtonStyle defaultStyleOf(BuildContext context)

Returns a ButtonStyle that's based primarily on the Theme's ThemeData.textTheme and ThemeData.colorScheme, but has most values filled out (non-null).

The returned style can be overridden by the style parameter and by the style returned by themeStyleOf that some button-specific themes like TextButtonTheme or ElevatedButtonTheme override. For example the default style of the TextButton subclass can be overridden with its TextButton.style constructor parameter, or with a TextButtonTheme.

Concrete button subclasses should return a ButtonStyle with as many non-null properties as possible, where all of the non-null WidgetStateProperty properties resolve to non-null values.

Properties that can be null

Some properties, like ButtonStyle.fixedSize would override other values in the same ButtonStyle if set, so they are allowed to be null. Here is a summary of properties that are allowed to be null when returned in the ButtonStyle returned by this function, an why:

• ButtonStyle.fixedSize because it would override other values in the same ButtonStyle, like ButtonStyle.maximumSize.
• ButtonStyle.side because null is a valid value for a button that has no side. OutlinedButton returns a non-null default for this, however.
• ButtonStyle.backgroundBuilder and ButtonStyle.foregroundBuilder because they would override the ButtonStyle.foregroundColor and ButtonStyle.backgroundColor of the same ButtonStyle.

See also:

• themeStyleOf, returns the ButtonStyle of this button's component theme.

Implementation

@override
ButtonStyle defaultStyleOf(BuildContext context) {
  final ThemeData theme = Theme.of(context);
  final ColorScheme colorScheme = theme.colorScheme;

  return Theme.of(context).useMaterial3
      ? _MOutlinedButtonDefaultsM3(
          context: context,
          backgroundColor: backgroundColor,
          borderRadius: borderRadius,
          clearPadding: clearPadding,
          disabledForegroundColor: disabledColor,
          elevation: elevation,
          fixedSize: fixedSize,
          foregroundColor: foregroundColor,
          height: height,
          maximumSize: maximumSize,
          minimumSize: minimumSize,
          noHighlight: noHighlight,
          noSplash: noSplash,
          overlayColor: overlayColor,
          padding: padding,
          radius: radius,
          shadowColor: shadowColor,
          shape: shape,
          side: side,
          splashFactory: splashFactory,
          tapTargetSize: tapTargetSize,
          textStyle: textStyle,
          width: width,
        )
      : styleFrom(
          foregroundColor: colorScheme.primary,
          disabledForegroundColor: colorScheme.onSurface.withOpacity(0.38),
          backgroundColor: Colors.transparent,
          disabledBackgroundColor: Colors.transparent,
          shadowColor: theme.shadowColor,
          elevation: 0,
          textStyle: theme.textTheme.labelLarge,
          padding: _scaledPadding(context),
          minimumSize: const Size(64, 36),
          maximumSize: Size.infinite,
          side: BorderSide(
            color: Theme.of(context).colorScheme.onSurface.withOpacity(0.12),
          ),
          shape: const RoundedRectangleBorder(borderRadius: BorderRadius.all(Radius.circular(4))),
          enabledMouseCursor: SystemMouseCursors.click,
          disabledMouseCursor: SystemMouseCursors.basic,
          visualDensity: theme.visualDensity,
          tapTargetSize: theme.materialTapTargetSize,
          animationDuration: kThemeChangeDuration,
          enableFeedback: true,
          alignment: Alignment.center,
          splashFactory: InkRipple.splashFactory,
        );
}