桌面应用 / 系统课时
集中管理颜色字号与间距
集中管理颜色字号与间距
本篇解决 QML 界面中颜色、字体和布局参数散落导致难维护的问题。通过建立统一主题对象,把视觉常量集中管理,让多个页面能够共享一致的设计规则。
学习目标
- 理解为什么需要将 QML 样式值抽离为主题配置
- 掌握使用单例对象集中管理颜色、字号和间距
- 能够在页面中引用统一主题值并降低修改成本
为什么要集中管理视觉常量
在快速开发阶段,开发者经常直接在组件中填写颜色、字号和间距。例如按钮使用一个背景色,标题使用一个字体大小,列表间距又单独定义一次。页面数量增加后,修改主题颜色或调整整体密度会变得困难。
集中管理视觉常量的核心目标不是减少代码行数,而是建立稳定的设计约束。页面只描述组件结构和交互逻辑,颜色、字体、圆角等视觉决策由主题层统一提供。
常见需要抽离的值包括:
- 品牌色、背景色、文本色和状态色
- 标题、正文、辅助文字的字号
- 小、中、大三类间距
- 控件圆角半径和边框宽度
创建 QML 主题对象
在 Qt 6 QML 项目中,可以使用单例类型保存应用级主题值。下面创建一个简单主题文件。
qml
pragma Singleton
import QtQuick 6.5
QtObject {
id: theme
readonly property color primaryColor: "#2563EB"
readonly property color backgroundColor: "#F8FAFC"
readonly property color textColor: "#111827"
readonly property int titleFontSize: 24
readonly property int bodyFontSize: 16
readonly property int spacingSmall: 8
readonly property int spacingMedium: 16
readonly property int spacingLarge: 24
}这个对象只保存不可变的设计参数。使用 readonly 可以避免页面组件意外修改全局主题状态。
在组件中引用主题值
页面组件不再直接写颜色和尺寸,而是引用主题对象。
qml
import QtQuick 6.5
import QtQuick.Controls 6.5
import MyApp.Theme 1.0
Rectangle {
width: 400
height: 200
color: Theme.backgroundColor
Column {
anchors.centerIn: parent
spacing: Theme.spacingMedium
Text {
text: "Dashboard"
font.pixelSize: Theme.titleFontSize
color: Theme.textColor
}
Button {
text: "Confirm"
background: Rectangle {
color: Theme.primaryColor
radius: Theme.spacingSmall
}
}
}
}预期结果
text
页面背景、标题文字和按钮颜色均来自 Theme 对象。
修改主题文件中的颜色值后,所有引用该主题的组件同步变化。主题值设计时的边界
并不是所有数字都应该进入主题。只有会被多个页面共享、可能统一调整或代表设计规范的值才适合集中管理。
例如某个页面内部专用的动画时间,可以保留在组件内部;而应用统一的间距体系、颜色体系和字体等级,应放入主题。
通过主题层和组件层的职责分离,QML 页面可以保持简洁,同时支持后续的暗色模式、多品牌主题或整体视觉调整。
按自己的节奏,确认真正理解。