blendTextTheme property

Use selection surfaceMode and blendLevel in FlexColorScheme.light and FlexColorScheme.dark to also blend primary color into text themes for both ThemeData.textTheme and ThemeData.primaryTextTheme.

This feature is similar to the slightly colored texts seen in Material 3 when using "onColor" colored texts.

This feature does not work so well if you need to put text on a completely different colored container than the background color. Which is why this feature can be opted out of.

M3 has separate on colors for all colorscheme colors that can also be used for color matched text on each color. However, this slightly primary colored default text works very well for the slight primary colored M3 "neutral" surface colors with a primary hint too.

At heavy blend levels it may reduce contrast too much and can be turned off if so desired. This feature is a bit experimental in nature and will be improved over time. Expect minor changes to the visual result when using this option in future versions when actual Material 3 text theme Typography becomes available.

Defaults to false.

Style break info: In FCS before version 7, the default was true, and blended text themes were used by default. Going forward if you want it, and also if you had not defined earlier and don't want to break your apps past style, set blendTextTheme to true.