桌面应用 / 系统课时

用 State 描述界面状态

用 State 描述界面状态

复杂 QML 界面通常包含默认、选中、展开、禁用等多种状态。本篇学习使用 State 和 PropertyChanges 集中描述这些状态,让界面变化逻辑更清晰,减少分散的条件判断。

学习目标

  • 理解 QML State 如何描述对象属性集合的变化
  • 掌握 State 与 PropertyChanges 的基本写法
  • 能够设计可维护的多状态界面结构

理解 State 表达的问题

在简单界面中,可以直接通过条件表达式修改属性,例如根据变量切换颜色。但随着状态数量增加,大量条件判断会让代码难以维护。

State 提供了一种声明式方式:先定义界面有哪些状态,再描述每个状态下属性应该是什么值。

QML State 状态切换关系示意图

使用 PropertyChanges 定义状态属性

下面示例定义一个卡片组件。默认状态显示普通样式,selected 状态改变颜色和尺寸。

qml
import QtQuick

Rectangle {
    id: card
    width: 200
    height: 120
    color: "lightgray"
    radius: 8

    property bool selected: false

    states: [
        State {
            name: "selected"
            when: card.selected

            PropertyChanges {
                target: card
                width: 240
                height: 160
                color: "skyblue"
            }
        }
    ]

    MouseArea {
        anchors.fill: parent
        onClicked: card.selected = !card.selected
    }
}

预期结果

点击矩形后,组件进入 selected 状态,宽高和颜色发生变化;再次点击后恢复默认状态。

State 与条件绑定的区别

两种方式都能改变界面,但适用场景不同。

方式 特点 适用场景
条件绑定 直接根据表达式计算属性 简单动态值变化
State 集中管理一组属性变化 多种界面模式切换

当一个状态需要同时修改多个属性时,State 更容易阅读。例如选中状态可能同时影响颜色、边框、尺寸和可见性,把这些变化放在一个 State 中比散落在多个绑定中更清晰。

组织多个界面状态

一个组件可以定义多个 State,例如默认状态、编辑状态、禁用状态。每个状态只描述与默认状态不同的属性,不需要重复整个组件定义。

配合 Behavior 后,State 负责提供目标值,动画负责处理变化过程,可以形成清晰的状态驱动界面设计。

在设计组件时,应优先考虑“组件有哪些稳定状态”,再决定每个状态需要修改哪些属性。这样可以避免事件处理函数中堆积大量界面更新代码。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 State 描述界面状态

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

登录哪都通