桌面应用 / 系统课时
用 delegate 定义数据项界面
用 delegate 定义数据项界面
本篇解决模型数据如何转换为用户可见列表项的问题。你将学习 delegate 的作用,掌握如何访问模型角色和索引信息,并创建可复用的列表项界面。
学习目标
- 理解 delegate 与 model 数据之间的映射关系。
- 掌握 delegate 中访问角色和索引的方法。
- 能够实现基础动态列表展示。
理解 delegate 的职责
在 QML 模型视图中,model 提供数据,delegate 描述每一条数据应该如何显示。ListView 会根据模型中的数据数量创建对应数量的 delegate 实例。
delegate 不保存业务数据,而是通过模型提供的角色读取内容。当模型变化时,ListView 会自动重新计算需要显示的内容。
qml
import QtQuick
import QtQuick.Controls
ApplicationWindow {
visible: true
width: 400
height: 300
ListModel {
id: fruitModel
ListElement {
name: "Apple"
price: 3
}
ListElement {
name: "Orange"
price: 4
}
}
ListView {
anchors.fill: parent
model: fruitModel
delegate: Text {
text: index + ": " + name + " ¥" + price
}
}
}预期结果
text
列表显示:
0: Apple ¥3
1: Orange ¥4访问模型角色和索引
delegate 内可以直接访问 ListElement 定义的角色,例如 name、price。除此之外,ListView 还提供 index,表示当前数据项在模型中的位置。
当需要根据位置改变样式、处理点击事件或执行删除操作时,index 是常用信息。
如果角色名称与 QML 属性名称冲突,需要明确区分模型角色和组件自身属性,避免出现绑定错误。
创建可复用列表项
实际项目中,delegate 通常会拆分成独立组件,使列表结构更容易维护。例如商品列表可能包含图片、标题、价格和操作按钮,这些内容都可以封装在单独的 QML 文件中。
delegate 的核心目标是描述单条记录的视觉规则,而不是处理整个列表逻辑。列表增删改仍然应该作用于 model。
处理动态数据变化
当 ListModel 新增、删除或修改数据时,ListView 会根据模型变化自动更新对应 delegate。开发者不需要手动创建或销毁列表项。
这种机制让 QML 适合构建实时变化的界面,例如消息列表、任务状态面板和监控数据展示。
设计 delegate 时,应避免在其中保存不可恢复的临时状态。如果界面状态需要长期存在,应放回模型数据中管理。
按自己的节奏,确认真正理解。