桌面应用 / 系统课时
处理空数据加载和错误状态
处理空数据加载和错误状态
本篇解决数据视图只有成功路径的问题,学习如何在 QML 界面中表达加载中、无数据和加载失败三种状态,让动态数据页面具备完整的用户反馈能力。
学习目标
- 理解数据视图状态管理的基本模式。
- 使用 QML 属性控制不同状态界面切换。
- 为动态列表增加加载和错误反馈。
数据视图为什么需要状态管理
真实应用中的数据不会永远立即可用。网络请求可能需要等待,筛选条件可能返回空结果,接口也可能因为异常失败。如果界面只绑定正常数据区域,用户无法判断当前发生了什么。
常见的数据页面至少需要区分三种状态:正在加载、加载完成但没有数据、加载失败。
使用状态变量驱动界面切换
QML 中可以通过属性保存当前数据状态,再使用 Loader 或 visible 属性切换不同区域。下面示例展示一个简单列表页面的状态控制。
qml
import QtQuick
import QtQuick.Controls
ApplicationWindow {
width: 480
height: 320
visible: true
property string viewState: "loading"
Column {
anchors.centerIn: parent
spacing: 12
Text {
visible: viewState === "loading"
text: "正在加载数据..."
}
Text {
visible: viewState === "empty"
text: "暂无数据"
}
Text {
visible: viewState === "error"
text: "加载失败,请重试"
}
Button {
text: "模拟空数据"
onClicked: viewState = "empty"
}
Button {
text: "模拟错误"
onClicked: viewState = "error"
}
}
}预期输出
text
程序启动后显示“正在加载数据...”。
点击“模拟空数据”后显示“暂无数据”。
点击“模拟错误”后显示“加载失败,请重试”。将状态和数据模型连接起来
实际项目中,状态通常由数据层驱动。例如请求开始时设置 loading,请求成功后根据返回列表长度判断 empty 或 success,请求异常时进入 error。
不要直接通过列表数量判断所有情况,因为空列表和请求失败代表不同业务含义。空列表表示请求成功但没有内容,错误状态表示数据根本没有获取成功。
设计更好的错误恢复体验
错误状态通常应该提供重新加载入口。恢复操作需要重新触发数据请求,并在请求开始时重新进入 loading 状态。
当页面包含多个数据区域时,可以为每个区域维护独立状态,避免一个区域失败导致整个页面不可用。良好的状态划分可以让复杂桌面应用保持清晰的交互逻辑。
按自己的节奏,确认真正理解。