桌面应用 / 系统课时
在 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: Redproperty var 可以保存 JavaScript 对象或数组,但它不会提供像 C++ 类型系统那样明确的约束。因此,数组结构简单且只服务于当前界面时比较合适。
判断逻辑应该放在哪里
QML 中的 JavaScript 并不是业务层替代品。判断代码是否应该继续留在 QML,可以关注逻辑是否依赖界面。
| 类型 | 适合位置 |
|---|---|
| 控制按钮是否可点击 | QML |
| 格式化显示文本 | QML |
| 简单动画状态计算 | QML |
| 用户权限判断 | C++ 或业务层 |
| 数据同步和网络请求流程 | C++ 或服务层 |
| 复杂算法计算 | 独立模块 |
当一个函数开始处理大量数据、维护复杂状态,或者需要被多个页面复用时,继续堆积在 QML 会降低可维护性。此时应该通过 C++ 暴露接口,或者拆分为独立 JavaScript 模块。
避免 QML JavaScript 过度复杂
QML 的优势是描述界面关系。如果 JavaScript 代码逐渐变成完整业务程序,通常意味着职责划分出现问题。
常见信号包括:
- 单个函数包含大量条件分支
- 多个页面复制相同计算逻辑
- 逻辑需要单元测试但只能通过界面触发
- 数据变化依赖多个外部系统
保持 QML 逻辑轻量,可以让界面响应更容易理解,也方便后续使用 C++ 模型或服务层扩展应用。
按自己的节奏,确认真正理解。