桌面应用 / 系统课时

用 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 时,应避免在其中保存不可恢复的临时状态。如果界面状态需要长期存在,应放回模型数据中管理。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 delegate 定义数据项界面

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

登录哪都通