Color Scheme
封装了 Material Design 3 的颜色方案(Color Scheme)。
颜色方案包含了一组命名的颜色参数,旨在确保和谐统一的视觉效果、文本的可访问性,并区分 UI 元素和表面。 此接口允许在自动化脚本中查询当前主题的颜色值,或通过声明式的方式自定义主题颜色。
Material 颜色系统基于一系列色调调色板,这些调色板共同创建了浅色和深色方案。
了解更多关于颜色的信息,请参阅 Material Design 颜色。
Author
M8Test, [email protected], https://m8test.com
Functions
获取背景色(Background)。出现在可滚动内容后面的基础背景色。
获取错误容器颜色(ErrorContainer)。错误状态的首选色调容器颜色。
获取反向表面上使用的颜色(InverseOnSurface)。与 getInverseSurface 形成良好对比,用于其上的文本和图标。
获取反向主色(InversePrimary)。在需要反色方案的地方(例如深色 SnackBar 上的按钮)用作“主色”。
获取反向表面颜色(InverseSurface)。与 getSurface 形成强烈对比,适用于例如 SnackBar 的背景。
获取背景色上使用的颜色(OnBackground)。用于显示在背景色之上的文本和图标。
获取错误色上使用的颜色(OnError)。用于显示在错误色之上的文本和图标。
获取错误容器上使用的颜色(OnErrorContainer)。用于显示在 getErrorContainer 之上的内容。
获取主色上使用的颜色(OnPrimary)。用于显示在主色之上的文本和图标。
获取主色容器上使用的颜色(OnPrimaryContainer)。用于显示在 getPrimaryContainer 之上的内容。
获取次色上使用的颜色(OnSecondary)。用于显示在次色之上的文本和图标。
获取次色容器上使用的颜色(OnSecondaryContainer)。用于显示在 getSecondaryContainer 之上的内容。
获取表面上使用的颜色(OnSurface)。用于显示在表面颜色之上的文本和图标。
获取表面变体上使用的颜色(OnSurfaceVariant)。用于显示在 getSurfaceVariant 之上的内容。
获取三级颜色上使用的颜色(OnTertiary)。用于显示在三级颜色之上的文本和图标。
获取三级颜色容器上使用的颜色(OnTertiaryContainer)。用于显示在 getTertiaryContainer 之上的内容。
获取轮廓色(Outline)。用于边界的细微颜色,如输入框的边框。提供足够的对比度以满足无障碍要求。
获取轮廓变体色(OutlineVariant)。用于装饰性元素的边界,当不需要强对比度时使用,例如分割线。
获取主色(Primary)。主色是应用屏幕和组件中最频繁显示的颜色,例如用于按钮背景。
获取主色容器颜色(PrimaryContainer)。用于需要比主色更少强调的元素的填充色。
获取次色(Secondary)。次色提供了更多方式来强调和区分产品,适用于浮动操作按钮、选择控件、高亮文本等。
获取次色容器颜色(SecondaryContainer)。
获取表面颜色(Surface)。影响组件表面(如卡片、底部栏和菜单)的基础颜色。
获取明亮表面(SurfaceBright)。无论在浅色还是深色模式下,总是比 getSurface 更亮。
获取表面容器(SurfaceContainer)。影响组件容器(如卡片、菜单)的 getSurface 变体。
获取高强调表面容器(SurfaceContainerHigh)。用于需要比 getSurfaceContainer 更多强调的内容。
获取最高强调表面容器(SurfaceContainerHighest)。用于需要比 getSurfaceContainerHigh 更多强调的内容。
获取低强调表面容器(SurfaceContainerLow)。用于需要比 getSurfaceContainer 更少强调的内容。
获取最低强调表面容器(SurfaceContainerLowest)。用于需要比 getSurfaceContainerLow 更少强调的内容。
获取暗淡表面(SurfaceDim)。无论在浅色还是深色模式下,总是比 getSurface 更暗。
获取表面色调(SurfaceTint)。此颜色将由应用色调海拔的组件使用,并覆盖在 getSurface 之上。海拔越高,此颜色越明显。
获取表面变体颜色(SurfaceVariant)。getSurface 的另一种选择,用于区分不同的表面区域。
获取三级颜色(Tertiary)。用于平衡主色和次色,或对特定元素(如输入字段)引起高度注意。
获取三级颜色容器(TertiaryContainer)。
设置背景色(Background)。
设置错误容器颜色(ErrorContainer)。
设置反向表面上使用的颜色(InverseOnSurface)。
设置反向主色(InversePrimary)。
设置反向表面颜色(InverseSurface)。
设置背景色上使用的颜色(OnBackground)。
设置错误色上使用的颜色(OnError)。
设置错误容器上使用的颜色(OnErrorContainer)。
设置主色上使用的颜色(OnPrimary)。
设置主色容器上使用的颜色(OnPrimaryContainer)。
设置次色上使用的颜色(OnSecondary)。
设置次色容器上使用的颜色(OnSecondaryContainer)。
设置表面上使用的颜色(OnSurface)。
设置表面变体上使用的颜色(OnSurfaceVariant)。
设置三级颜色上使用的颜色(OnTertiary)。
设置三级颜色容器上使用的颜色(OnTertiaryContainer)。
设置轮廓色(Outline)。
设置轮廓变体色(OutlineVariant)。
设置主色(Primary)。
设置主色容器颜色(PrimaryContainer)。
设置次色(Secondary)。
设置次色容器颜色(SecondaryContainer)。
设置表面颜色(Surface)。
设置明亮表面(SurfaceBright)。
设置表面容器(SurfaceContainer)。
设置高强调表面容器(SurfaceContainerHigh)。
设置最高强调表面容器(SurfaceContainerHighest)。
设置低强调表面容器(SurfaceContainerLow)。
设置最低强调表面容器(SurfaceContainerLowest)。
设置暗淡表面(SurfaceDim)。
设置表面色调(SurfaceTint)。通常与主色相同。
设置表面变体颜色(SurfaceVariant)。
设置三级颜色(Tertiary)。
设置三级颜色容器(TertiaryContainer)。