桌面应用 / 系统课时

在 QML 中编写轻量 JavaScript

在 QML 中编写轻量 JavaScript

本篇解决如何在 QML 中处理简单交互逻辑的问题。你将使用 JavaScript 函数、条件判断和数组完成界面级计算,同时掌握哪些逻辑应该留在 QML,哪些应该交给 C++ 或独立业务层。

学习目标

  • 理解 QML 中 JavaScript 代码的适用范围和执行方式
  • 掌握函数、条件和数组在界面逻辑中的基本写法
  • 能够判断 QML 逻辑是否应该迁移到其他层

使用 JavaScript 处理界面行为

QML 内置支持 JavaScript 表达式,适合描述与界面状态直接相关的小逻辑,例如格式化文本、计算按钮状态、处理简单输入变化。它的优势是代码靠近界面,修改交互规则时不需要切换文件。

例如,一个计数器组件可以在 QML 内部保存状态,并通过函数计算显示文本:

qml
import QtQuick

Item {
    property int count: 0

    function statusText(value) {
        if (value === 0) {
            return "等待操作"
        }
        return "当前数量: " + value
    }

    Text {
        text: statusText(count)
    }

    MouseArea {
        anchors.fill: parent
        onClicked: count++
    }
}

预期输出

text
初始显示:等待操作
每次点击区域后显示:当前数量: 1、当前数量: 2……

这里的函数只负责界面展示相关转换,没有访问数据库、调用复杂服务或处理长期业务规则,因此适合放在 QML 中。

使用数组保存临时界面数据

JavaScript 数组可以用于保存短生命周期的数据,例如菜单项、过滤条件或临时选择结果。对于固定结构的小数据集合,直接使用数组可以减少额外代码。

qml
import QtQuick

Item {
    property var colors: ["Red", "Green", "Blue"]

    function firstColor() {
        return colors[0]
    }

    Component.onCompleted: {
        console.log(firstColor())
    }
}

预期输出

text
qml: Red

property var 可以保存 JavaScript 对象或数组,但它不会提供像 C++ 类型系统那样明确的约束。因此,数组结构简单且只服务于当前界面时比较合适。

判断逻辑应该放在哪里

QML 中的 JavaScript 并不是业务层替代品。判断代码是否应该继续留在 QML,可以关注逻辑是否依赖界面。

类型 适合位置
控制按钮是否可点击 QML
格式化显示文本 QML
简单动画状态计算 QML
用户权限判断 C++ 或业务层
数据同步和网络请求流程 C++ 或服务层
复杂算法计算 独立模块

当一个函数开始处理大量数据、维护复杂状态,或者需要被多个页面复用时,继续堆积在 QML 会降低可维护性。此时应该通过 C++ 暴露接口,或者拆分为独立 JavaScript 模块。

避免 QML JavaScript 过度复杂

QML 的优势是描述界面关系。如果 JavaScript 代码逐渐变成完整业务程序,通常意味着职责划分出现问题。

常见信号包括:

  • 单个函数包含大量条件分支
  • 多个页面复制相同计算逻辑
  • 逻辑需要单元测试但只能通过界面触发
  • 数据变化依赖多个外部系统

保持 QML 逻辑轻量,可以让界面响应更容易理解,也方便后续使用 C++ 模型或服务层扩展应用。

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

目录与阅读设置

阅读设置

17

记录一个想法

在 QML 中编写轻量 JavaScript

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

登录哪都通