FlexColorExtensions extension

Extensions on Color to brighten, lighten, darken and blend colors and can get a shade for gradients.

Some of the extensions are rewrites of TinyColor's functions https://pub.dev/packages/tinycolor. The TinyColor algorithms have also been modified to use Flutter's HSLColor class instead of the custom one in the TinyColor lib. The functions from TinyColor re-implemented as Color extensions here are brighten, lighten and darken. They are used for color calculations in FlexColorScheme, but also exposed for reuse.

Another frequently used extension is blend and blendAlpha used to blend two colors using alpha as a percentage or as an 8-bit int alpha value. This extension is used to calculate branded surface colors used by FlexColorScheme's branded surfaces and for automatic dark color schemes from a light scheme.

The getShadeColor extension is less frequently used and when used, typically used to color makes colors shades for gradient AppBars, with default setting to not change black and white.

The color extension also include getting a color's RGB hex code as a string in two different formats. Extension hexCode returns a Flutter style HEX code string of a Color value, meaning it starts with 0x and alpha value before the RGB Hex values. The plain hex extension returns a typical API formatted hex color string starting with # and no alpha value.

on

• Color

Properties

hex → String

Available on Color, provided by the FlexColorExtensions extension

Return uppercase RGB hex code string, with # and no alpha value. This format is often used in APIs and in CSS color values..

no setter

hexCode → String

Available on Color, provided by the FlexColorExtensions extension

Return uppercase Flutter style hex code string of the color.

no setter

isDark → bool

Available on Color, provided by the FlexColorExtensions extension

Returns true if the color's brightness is Brightness.dark, else false.

no setter

isLight → bool

Available on Color, provided by the FlexColorExtensions extension

Returns true if the color's brightness is Brightness.light, else false.

no setter

onColor → Color

Available on Color, provided by the FlexColorExtensions extension

Get the right black or white contrasting onColor for a color.

no setter

Methods

blend(Color input, [int amount = 10]) → Color

Available on Color, provided by the FlexColorExtensions extension

Blend in the given input Color with a percentage of alpha.

blendAlpha(Color input, [int alpha = 0x0A]) → Color

Available on Color, provided by the FlexColorExtensions extension

Blend in the given input Color with an alpha value.

brighten([int amount = 10]) → Color

Available on Color, provided by the FlexColorExtensions extension

Brightens the color with the given integer percentage amount. Defaults to 10%.

darken([int amount = 10]) → Color

Available on Color, provided by the FlexColorExtensions extension

Darkens the color with the given integer percentage amount. Defaults to 10%.

getShadeColor({int shadeValue = 15, bool lighten = true, bool keepBlack = true, bool keepWhite = true}) → Color

Available on Color, provided by the FlexColorExtensions extension

The getShadeColor extension is used to make a color darker or lighter, the shadeValue defines the amount in % that the shade should be changed.

lighten([int amount = 10]) → Color

Available on Color, provided by the FlexColorExtensions extension

Lightens the color with the given integer percentage amount. Defaults to 10%.