桌面应用 / 系统课时

集中管理颜色字号与间距

集中管理颜色字号与间距

本篇解决 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 页面可以保持简洁,同时支持后续的暗色模式、多品牌主题或整体视觉调整。

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

目录与阅读设置

阅读设置

17

记录一个想法

集中管理颜色字号与间距

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

登录哪都通