ColorScheme

fun copy(
    primary: Color = this.primary,
    primaryDim: Color = this.primaryDim,
    primaryContainer: Color = this.primaryContainer,
    onPrimary: Color = this.onPrimary,
    onPrimaryContainer: Color = this.onPrimaryContainer,
    secondary: Color = this.secondary,
    secondaryDim: Color = this.secondaryDim,
    secondaryContainer: Color = this.secondaryContainer,
    onSecondary: Color = this.onSecondary,
    onSecondaryContainer: Color = this.onSecondaryContainer,
    tertiary: Color = this.tertiary,
    tertiaryDim: Color = this.tertiaryDim,
    tertiaryContainer: Color = this.tertiaryContainer,
    onTertiary: Color = this.onTertiary,
    onTertiaryContainer: Color = this.onTertiaryContainer,
    surfaceContainerLow: Color = this.surfaceContainerLow,
    surfaceContainer: Color = this.surfaceContainer,
    surfaceContainerHigh: Color = this.surfaceContainerHigh,
    onSurface: Color = this.onSurface,
    onSurfaceVariant: Color = this.onSurfaceVariant,
    outline: Color = this.outline,
    outlineVariant: Color = this.outlineVariant,
    background: Color = this.background,
    onBackground: Color = this.onBackground,
    error: Color = this.error,
    errorDim: Color = this.errorDim,
    errorContainer: Color = this.errorContainer,
    onError: Color = this.onError,
    onErrorContainer: Color = this.onErrorContainer
): ColorScheme

Returns a copy of this Colors, optionally overriding some of the values.

val background: Color

The background color that appears behind other content.

val error: Color

Color that indicates remove, delete, close or dismiss actions, such as Swipe to Reveal. Added as a slightly less alarming and urgent alternative to errorContainer than the error dim color.

val errorContainer: Color

A less prominent container color than error, for components using the error state. Can also indicate an active error state which feels less interactive than a filled state, such as an active emergency sharing button, or on a failed overlay dialog..

val errorDim: Color

Indicates high priority errors or emergency actions, such as safety alerts, failed dialog overlays or stop buttons.

val onBackground: Color

Color used for text and icons displayed on top of the background color.

val onError: Color

Color used for text and icons displayed on top of the error color.

val onErrorContainer: Color

Color used for text and icons on the errorContainer color.

val onPrimary: Color

Color used for text and icons displayed on top of the primary color.

val onPrimaryContainer: Color

The color (and state variants) that should be used for content on top of primaryContainer.

val onSecondary: Color

Color used for text and icons displayed on top of the secondary color.

val onSecondaryContainer: Color

The color (and state variants) that should be used for content on top of secondaryContainer.

val onSurface: Color

Color used for text and icons displayed on top of the surface color.

val onSurfaceVariant: Color

The color for secondary text and icons on top of surfaceContainer.

val onTertiary: Color

Color used for text and icons displayed on top of the tertiary color.

val onTertiaryContainer: Color

The color (and state variants) that should be used for content on top of tertiaryContainer.

val outline: Color

The main color for primary outline components. The outline color role adds contrast for accessibility purposes.

val outlineVariant: Color

The secondary color for secondary outline components.

val primary: Color

The primary color is the color displayed most frequently across your app’s screens and components.

val primaryContainer: Color

is a standout container color for key components.

val primaryDim: Color

is less prominent than primary for component backgrounds

val secondary: Color

The secondary color provides more ways to accent and distinguish your product.

val secondaryContainer: Color

A tonal color to be used in containers.

val secondaryDim: Color

is less prominent than secondary for component backgrounds.

val surfaceContainer: Color

The main surface color that affect surfaces of components with large containment areas, such as Card and Button.

val surfaceContainerHigh: Color

A surface color used for large containment components such Card and Button with high prominence.

val surfaceContainerLow: Color

A surface color used for large containment components such as Card and Button with low prominence.

val tertiary: Color

The tertiary color that can be used to balance primary and secondary colors, or bring heightened attention to an element.

val tertiaryContainer: Color

A tonal color to be used in containers.

val tertiaryDim: Color

A less prominent tertiary color that can be used to balance primary and secondary colors, or bring heightened attention to an element.

fun ColorScheme.contentColorFor(backgroundColor: Color): Color

The Material color system contains pairs of colors that are typically used for the background and content color inside a component. For example, a Button typically uses primary for its background, and onPrimary for the color of its content (usually text or iconography).

This function tries to match the provided backgroundColor to a 'background' color in this ColorScheme, and then will return the corresponding color used for content. For example, when backgroundColor is ColorScheme.primary, this will return ColorScheme.onPrimary.

If backgroundColor does not match a background color in the theme, this will return Color.Unspecified.