桌面应用 / 系统课时
为深浅主题准备颜色体系
为深浅主题准备颜色体系
本篇解决 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 文本颜色来自主题接口。
修改主题配置后,组件无需调整代码即可响应变化。这种方式可以让按钮、列表、弹窗等组件共享同一套颜色规则,避免界面出现颜色风格不一致的问题。
规划颜色体系的边界
语义颜色并不意味着所有颜色都必须抽象。过度抽象会产生大量难以理解的名称。
通常可以优先抽象以下类型:
- 页面背景、卡片背景等结构颜色。
- 主文本、辅助文本、禁用文本等文字颜色。
- 主操作色、警告色、错误色等状态颜色。
对于一次性装饰效果,例如特殊插图中的渐变色,可以保留在组件内部。
建立主题体系后,组件只依赖稳定语义,设计调整和深浅模式切换都会集中在颜色定义层完成。
按自己的节奏,确认真正理解。