/* * Copyright 2019 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package androidx.compose.material import androidx.compose.foundation.LocalIndication import androidx.compose.material.ripple.LocalRippleTheme import androidx.compose.material.ripple.RippleTheme import androidx.compose.material.ripple.rememberRipple import androidx.compose.runtime.Composable import androidx.compose.runtime.Immutable import androidx.compose.runtime.CompositionLocalProvider import androidx.compose.runtime.ReadOnlyComposable import androidx.compose.runtime.remember import androidx.compose.foundation.text.selection.LocalTextSelectionColors /** * Material Theming. * * Material Theming refers to the customization of your Material Design app to better reflect your * product’s brand. * * Material components such as [Button] and [Checkbox] use values provided here when retrieving * default values. * * It defines colors as specified in the [Material Color theme creation spec](https://material.io/design/color/the-color-system.html#color-theme-creation), * typography defined in the [Material Type Scale spec](https://material.io/design/typography/the-type-system.html#type-scale), * and shapes defined in the [Shape scheme](https://material.io/design/shape/applying-shape-to-ui.html#shape-scheme). * * All values may be set by providing this component with the [colors][Colors], * [typography][Typography], and [shapes][Shapes] attributes. Use this to configure the overall * theme of elements within this MaterialTheme. * * Any values that are not set will inherit the current value from the theme, falling back to the * defaults if there is no parent MaterialTheme. This allows using a MaterialTheme at the top * of your application, and then separate MaterialTheme(s) for different screens / parts of your * UI, overriding only the parts of the theme definition that need to change. * * @sample androidx.compose.material.samples.MaterialThemeSample * * @param colors A complete definition of the Material Color theme for this hierarchy * @param typography A set of text styles to be used as this hierarchy's typography system * @param shapes A set of shapes to be used by the components in this hierarchy */ @Composable fun MaterialTheme( colors: Colors = MaterialTheme.colors, typography: Typography = MaterialTheme.typography, shapes: Shapes = MaterialTheme.shapes, content: @Composable () -> Unit ) { val rememberedColors = remember { // Explicitly creating a new object here so we don't mutate the initial [colors] // provided, and overwrite the values set in it. colors.copy() }.apply { updateColorsFrom(colors) } val rippleIndication = rememberRipple() val selectionColors = rememberTextSelectionColors(rememberedColors) CompositionLocalProvider( LocalColors provides rememberedColors, LocalContentAlpha provides ContentAlpha.high, LocalIndication provides rippleIndication, LocalRippleTheme provides MaterialRippleTheme, LocalShapes provides shapes, LocalTextSelectionColors provides selectionColors, LocalTypography provides typography ) { ProvideTextStyle(value = typography.body1) { PlatformMaterialTheme(content) } } } @Composable internal expect fun PlatformMaterialTheme(content: @Composable () -> Unit) /** * Contains functions to access the current theme values provided at the call site's position in * the hierarchy. */ object MaterialTheme { /** * Retrieves the current [Colors] at the call site's position in the hierarchy. * * @sample androidx.compose.material.samples.ThemeColorSample */ val colors: Colors @Composable @ReadOnlyComposable get() = LocalColors.current /** * Retrieves the current [Typography] at the call site's position in the hierarchy. * * @sample androidx.compose.material.samples.ThemeTextStyleSample */ val typography: Typography @Composable @ReadOnlyComposable get() = LocalTypography.current /** * Retrieves the current [Shapes] at the call site's position in the hierarchy. */ val shapes: Shapes @Composable @ReadOnlyComposable get() = LocalShapes.current } @Immutable private object MaterialRippleTheme : RippleTheme { @Composable override fun defaultColor() = RippleTheme.defaultRippleColor( contentColor = LocalContentColor.current, lightTheme = MaterialTheme.colors.isLight ) @Composable override fun rippleAlpha() = RippleTheme.defaultRippleAlpha( contentColor = LocalContentColor.current, lightTheme = MaterialTheme.colors.isLight ) }