桌面应用 / 系统课时

用 GridView 排卡片数据

用 GridView 排卡片数据

本节解决桌面应用中常见的卡片网格展示需求。通过 GridView 将模型数据转换为二维排列界面,并根据窗口尺寸动态调整卡片布局。

学习目标

  • 理解 GridView 与 ListView 在布局方式上的区别
  • 掌握 delegate 卡片布局和网格参数配置
  • 学会根据窗口宽度调整网格排列策略

理解 GridView 的布局模型

GridView 与 ListView 都属于 QML 模型视图组件,但它们解决的问题不同。ListView 按一条轴排列数据,而 GridView 会根据 cellWidth 和 cellHeight 将项目排列成网格。

例如图片管理器、应用启动器、商品展示页等场景,都更适合使用 GridView。

GridView 卡片布局随窗口宽度变化示意图

使用 GridView 显示卡片数据

GridView 同样依赖 model 和 delegate。delegate 定义每张卡片的外观,GridView 负责计算排列位置。

qml
import QtQuick
import QtQuick.Controls

ApplicationWindow {
    width: 640
    height: 480
    visible: true

    ListModel {
        id: appModel
        ListElement { title: "Calendar" }
        ListElement { title: "Notes" }
        ListElement { title: "Music" }
        ListElement { title: "Photos" }
    }

    GridView {
        anchors.fill: parent
        model: appModel
        cellWidth: 160
        cellHeight: 120

        delegate: Rectangle {
            width: 140
            height: 100
            radius: 8
            color: "lightgray"

            Text {
                anchors.centerIn: parent
                text: model.title
            }
        }
    }
}

预期结果

text
窗口中显示四张卡片。
卡片按照 GridView 的 cellWidth 和 cellHeight 自动排列。

根据窗口宽度调整排列

固定 cellWidth 可以满足简单场景,但桌面应用通常需要适配不同窗口尺寸。可以根据可用宽度计算列数。

GridView 提供 width 和 cellWidth 等信息,可以通过绑定动态调整布局。

qml
GridView {
    anchors.fill: parent
    model: appModel
    cellWidth: width < 500 ? 120 : 160
    cellHeight: 120
}

预期结果

text
窗口较窄时使用较小卡片宽度。
窗口变宽后自动使用更大的卡片尺寸。

实际项目中也可以根据窗口宽度计算列数量,例如控制每行显示 3 到 6 张卡片,保持界面密度稳定。

处理卡片选择和交互

GridView 同样支持 currentIndex,可以用于表示当前卡片。卡片 delegate 中可以根据当前状态改变边框、背景或动画效果。

与 ListView 类似,点击事件通常通过 GridView.view.currentIndex 修改当前索引,而不要直接修改 delegate 内部临时状态。

GridView 与 ListView 的选择

场景 推荐组件
消息、日志、联系人列表 ListView
图片墙、应用入口、商品卡片 GridView
需要连续滚动的一维内容 ListView
需要二维视觉排列 GridView

选择组件时,应优先考虑用户看到的数据关系,而不是模型本身的数据结构。相同模型可以根据交互目标切换不同视图。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 GridView 排卡片数据

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

登录哪都通