桌面应用 / 系统课时

用 PropertyAnimation 改变属性

用 PropertyAnimation 改变属性

PropertyAnimation 用来让属性值在一段时间内平滑变化。本课用一个可运行的 Qt 6 QML 状态切换示例,同时动画 x 与 opacity,并用 duration、easing.type 控制速度和节奏。

学习目标

  • 能指定要动画的属性,并区分单一 property 与多属性 properties 的使用场景。
  • 能为桌面交互选择合理的 duration 与 easing,并知道如何快速调参。
  • 能把 PropertyAnimation 放进 Transition,让状态切换自动补间并完成结果检查。

先确定属性和值怎么变化

动画前先写清“起点、终点、时长”。桌面界面通常优先处理位置、尺寸和透明度;下面的数值是可用于第一版原型的起步建议,不是强制规范。

场景 属性例子 建议起步时长 easing 起步选择
按钮或小浮层出现 opacity 120~180 ms Easing.OutCubic
卡片横向移动 x 200~320 ms Easing.InOutCubic
面板展开 width、height 220~360 ms Easing.OutCubic
轻微强调回弹 位置或尺寸 300~450 ms Easing.OutBack

如果只控制一个目标属性,优先写 property: "x";在 Transition 中多个属性都由状态提供各自起止值时,可以写 properties: "x,opacity",让同一动画规则匹配这两个属性。

PropertyAnimation 属性随时间变化示意图

图里的重点不是曲线形状本身,而是两个属性共享 420 ms 时间窗,却拥有各自不同的起止值。使用 Transition 时,这些值可以直接来自状态前后的属性变化。

在 Transition 中执行 PropertyAnimation

下面的 Main.qml 是完整示例。点击蓝色卡片会在基础状态和 moved 状态之间切换;PropertyAnimation 不写固定 from、to,而是让 Transition 根据状态变化自动取得每个属性的起点和终点。

qml
import QtQuick

Window {
    id: root
    width: 720
    height: 320
    visible: true
    title: "PropertyAnimation Demo"
    color: "#f4f5f7"

    Rectangle {
        id: card
        property bool moved: false

        x: 40
        y: 110
        width: 160
        height: 96
        radius: 12
        color: "#2f6feb"
        opacity: 1.0

        Text {
            anchors.centerIn: parent
            text: "点击切换"
            color: "white"
            font.pixelSize: 18
        }

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

        states: State {
            when: card.moved
            PropertyChanges {
                target: card
                x: root.width - card.width - 40
                opacity: 0.45
            }
        }

        transitions: Transition {
            PropertyAnimation {
                properties: "x,opacity"
                duration: 420
                easing.type: Easing.InOutCubic
            }
        }
    }
}

预期结果

text
首次点击后,卡片在 420 ms 内从 x=40 移到窗口右侧,并把 opacity 从 1.0 降到 0.45;再次点击时按相同节奏回到左侧并恢复为 1.0。窗口宽度变化后,右侧终点仍保留 40 px 边距。

这个写法适合“状态决定最终界面,Transition 只负责过程”的场景。相比在点击事件里手工计算每一帧,它更容易保证动画结束后属性值与界面状态一致。

用 duration 与 easing 调节节奏

调参时一次只改一个维度。先固定 easing.type: Easing.Linear 或 Easing.InOutCubic,把 duration 从 420 改成 180、280、420 ms 连续比较;选出速度后,再切换 easing 判断启动和停止是否自然。这样能避免同时改两个参数后无法判断差异来自哪里。

Easing.OutBack 会产生超出终点再回落的视觉感,适合少量强调,不适合菜单定位、数据表格或需要精确空间感的移动。业务界面若不确定,从 Easing.OutCubic 或 Easing.InOutCubic 开始更容易控制。

检查动画边界和控制权

第一项检查是终点是否正确。把窗口宽度分别改为 360、720、960 px,点击后确认卡片右侧始终保留 40 px;第二项检查是连续点击 5 次,确认最终 x 与 opacity 总能落到当前状态对应的值,而不是停在中间。

第三项检查是属性有没有被其他系统控制。如果同一水平轴已经由 anchors.left、anchors.right 或 anchors.horizontalCenter 决定,就不要同时把 x 当成自由动画属性;需要移动时应移除该轴锚点,或在状态切换锚点时改用专门处理锚点过渡的 AnchorAnimation。

排查动画“看起来没动”时,先把 duration 临时改成 1000 ms,再观察属性是否缓慢变化;如果仍然没有变化,优先检查目标属性是否被 binding、anchors 或 Layout 立即重算。确认控制权只有一处后,再把时长恢复到交互需要的范围。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 PropertyAnimation 改变属性

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

登录哪都通