桌面应用 / 系统课时

为深浅主题准备颜色体系

为深浅主题准备颜色体系

本篇解决 QML 界面主题切换中颜色难以维护的问题,通过建立语义颜色层,将按钮、背景、文本等角色与具体色值分离,让浅色和深色主题拥有统一的组件接口。

学习目标

  • 理解语义颜色与具体色值分离的设计方式。
  • 使用 QML 对象组织可切换的主题颜色。
  • 在组件中引用主题接口,降低主题变化带来的修改成本。

为什么需要语义颜色

直接在组件中写入颜色值是小型界面中常见的做法,例如背景使用白色、文字使用黑色。但当应用需要支持深色模式时,大量组件都会依赖具体颜色,修改成本会快速增加。

语义颜色解决的是“这个颜色代表什么”,而不是“它具体是什么”。例如,background 表示窗口背景,textPrimary 表示主要文本,组件只关心颜色角色,不关心当前主题使用了哪组色值。

深浅主题切换时,只需要替换颜色集合,组件代码无需变化。

设计主题颜色对象

在 QML 中可以使用普通 JavaScript 对象保存主题定义,也可以通过单例类型提供全局访问接口。下面使用简单对象演示核心结构。

qml
pragma Singleton
import QtQuick

QtObject {
    property bool darkMode: false

    readonly property color background: darkMode ? "#202124" : "#ffffff"
    readonly property color surface: darkMode ? "#303134" : "#f5f5f5"
    readonly property color textPrimary: darkMode ? "#ffffff" : "#202124"
    readonly property color accent: darkMode ? "#8ab4f8" : "#1967d2"
}

预期结果

text
主题对象提供 background、surface、textPrimary 和 accent 等稳定颜色接口。
切换 darkMode 后,读取这些属性的组件会自动获得新的颜色值。

这里的关键不是保存多少颜色,而是定义稳定的语义名称。后续新增组件时,应优先寻找已有语义颜色,而不是创建新的临时颜色。

在组件中使用主题颜色

组件不应该直接依赖主题内部的色值,而应该绑定语义属性。

qml
Rectangle {
    width: 240
    height: 120

    color: Theme.surface

    Text {
        anchors.centerIn: parent
        text: "Settings"
        color: Theme.textPrimary
    }
}

预期结果

text
Rectangle 背景和 Text 文本颜色来自主题接口。
修改主题配置后,组件无需调整代码即可响应变化。

这种方式可以让按钮、列表、弹窗等组件共享同一套颜色规则,避免界面出现颜色风格不一致的问题。

规划颜色体系的边界

语义颜色并不意味着所有颜色都必须抽象。过度抽象会产生大量难以理解的名称。

通常可以优先抽象以下类型:

  • 页面背景、卡片背景等结构颜色。
  • 主文本、辅助文本、禁用文本等文字颜色。
  • 主操作色、警告色、错误色等状态颜色。

对于一次性装饰效果,例如特殊插图中的渐变色,可以保留在组件内部。

建立主题体系后,组件只依赖稳定语义,设计调整和深浅模式切换都会集中在颜色定义层完成。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

为深浅主题准备颜色体系

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通