blendOnColors property

bool blendOnColors
final

Set to true to enable blendOnLevel based onColor blending also on onPrimary, onSecondary and onTertiary colors.

Use blendOnLevel value to in FlexColorScheme themes to also blend in each corresponding ColorScheme color property's color into its onColors.

If blendOnColors is false, the blendOnLevel setting only affects onSurface, onBackGround, onPrimaryContainer, onSecondaryContainer onTertiaryContainer and onErrorContainer.

If blendOnColors is true, it also impacts onPrimary, onSecondary, onTertiary and onError.

Blending the on colors results in lower contrast than when not doing so, but it works well on lower blend levels. The effect can be adjusted with blendOnLevel and completely turned off by setting blendOnLevel to 0 (zero).

Defaults to true. Main colors also get hint of its own color in their onColor. Consider setting this property true in dark mode, and false in light theme mode, for a style that matches the Material 3 color design.

Implementation

final bool blendOnColors;