高级自定义:定义新颜色
应用、定义或调整颜色,打造经过精细调整的独特颜色体验
你可以在配色方案中添加颜色,以扩展 Material 默认提供的颜色角色。
定义静态颜色
旧称“自定义颜色”
你可以在配色方案中定义额外颜色;即使其他颜色动态变化,这些颜色仍保持静态。输入所需的参考颜色后,Material 会返回四个派生颜色角色,其设计与配色方案中现有角色保持一致。

在此示例中,除配色方案外,还定义了一种名为 Success 的静态绿色,并将其应用于 UI,以表示成功状态。
- 用于生成四个新颜色角色颜色值的绿色源色
- 由源色派生的一组新的“Success”颜色角色
- On success container 颜色应用于 WiFi 图标
- Success container 颜色应用于卡片容器
为什么使用
你可能需要在应用中使用静态颜色来体现品牌或传达语义,例如用绿色表示成功状态。通过 Material 系统定义这些颜色后,它们可与现有 Material 颜色协同工作,并支持动态色彩、用户可调对比度等功能。
如何使用
使用 Material Theme Builder 输入自定义颜色。Material 将返回由该参考颜色派生的四个颜色角色。主色、主色之上颜色、容器色和容器之上颜色均遵循主配色方案中强调色的约定,并可按相同对应关系应用于 UI。更多信息,请参阅在 UI 元素上映射或重新映射颜色。
最佳实践
- 如果基于输入颜色生成的颜色与预期不符,可以启用或禁用颜色保真度。颜色保真度 是一项让颜色色调与输入颜色保持一致的功能。
- Material 默认将红色 Error 颜色作为静态颜色示例提供,因此你无需为语义红色另行定义静态颜色。
- 如果你在动态配色方案中使用静态颜色,可以选择协调静态颜色,使其与配色方案的主色协调统一。协调会使静态颜色的色相略微偏暖或偏冷,从而获得更和谐的整体外观,同时保留与色相范围相关的语义。


定义自定义颜色角色
除了配色方案中已有的颜色角色,你还可以定义自定义颜色角色。按照与 Material 相同的方式定义这些角色(指定参照调色板、初始色调和对比度要求)后,它们可获得更符合你需求的颜色,同时与用户可调对比度等功能无缝兼容。

创建自定义颜色角色的示例:
- Primary 色调调色板,其中色调 50 被设为 primary graphic 的默认值
- 色样显示 primary graphic 与 primary container 之间符合无障碍要求的 3:1 对比度
- primary graphic 颜色角色应用于天气小组件中,以 primary container 为背景
为什么使用
如果配色方案中现有的颜色或额外的静态颜色无法满足产品需求,你可能需要定义自定义颜色角色。建议在 Material 系统内创建这些角色,以兼容动态色彩,并支持用户可调对比度等其他功能。
如何使用
通过指定以下标准,将新颜色定义为颜色角色:
- 调色板和参照色调: 对于每个颜色角色,你必须分别为浅色和深色主题指定 Material 调色板(primary、secondary、tertiary、neutral、neutralVariant、error)和参照色调(例如:primary70、primary80、primary90……)中的取值。
- 颜色配对: 你必须指定设计中的视觉关系,例如共同用作前景和背景的颜色对,或需要保持明暗差异(色调差)的颜色对。
- 对比度: 确认自定义前景色与背景色的搭配符合 Material 的最低对比度要求。
明确上述标准后,你可以在自己的动态色彩对象中定义新的颜色角色。随后,对于每个颜色角色,你可以调用 Material Color Utilities (MCU),根据用户主题设置、对比度等级等条件动态生成颜色值。
最佳实践
仅当无法通过其他 Material 颜色解决方案实现所需颜色时,才应考虑定义自定义颜色角色。