跨平台开发 / 系统课时

用 GridView 构建网格页面

用 GridView 构建网格页面

本篇解决 Flutter 中重复元素网格展示的问题,通过 GridView 配置列数、间距和动态构建方式,实现商品列表、图片宫格等常见页面结构。

学习目标

  • 理解 GridView 的网格布局机制和常用构造方式
  • 掌握通过 delegate 配置列数、间距和子项生成逻辑
  • 能够根据实际页面需求选择合适的 GridView 用法

理解 GridView 的布局特点

列表布局通常是一维排列,而网格布局需要同时处理行和列。Flutter 的 GridView 通过 SliverGrid 系列布局算法,将子组件按照固定规则排列到二维空间中。

常见场景包括商品卡片、相册、分类入口和仪表盘模块。相比手动使用 Row 与 Column 组合,GridView 可以自动处理滚动、复用和动态数量变化。

使用 GridView.builder 创建动态网格

当网格数据来自接口或本地列表时,推荐使用 GridView.builder。它不会一次创建所有子组件,而是在滚动过程中按需构建,更适合长列表场景。

下面示例创建一个两列商品卡片布局:

dart
import 'package:flutter/material.dart';

class ProductGridPage extends StatelessWidget {
  ProductGridPage({super.key});

  final List<String> products = List.generate(20, (index) => '商品 ${index + 1}');

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('商品网格')),
      body: GridView.builder(
        padding: const EdgeInsets.all(16),
        gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount(
          crossAxisCount: 2,
          mainAxisSpacing: 12,
          crossAxisSpacing: 12,
          childAspectRatio: 1.2,
        ),
        itemCount: products.length,
        itemBuilder: (context, index) {
          return Card(
            child: Center(child: Text(products[index])),
          );
        },
      ),
    );
  }
}

预期结果

text
页面显示一个可滚动网格。
每行包含 2 个商品卡片。
卡片之间存在水平和垂直间距。

配置网格尺寸参数

SliverGridDelegateWithFixedCrossAxisCount 是最常用的固定列数方案,主要参数如下:

参数 作用
crossAxisCount 横向排列数量
mainAxisSpacing 行之间的间距
crossAxisSpacing 列之间的间距
childAspectRatio 子项宽高比例

如果希望根据屏幕宽度自动变化列数,可以使用 SliverGridDelegateWithMaxCrossAxisExtent,通过设置单个子项最大宽度,让 Flutter 自动计算列数。

选择合适的 GridView 方式

固定分类入口、首页宫格等布局通常提前知道结构,可以直接使用 GridView.count。

数据数量动态变化或可能较多时,应优先使用 GridView.builder,避免无意义的组件创建。

需要响应不同屏幕宽度时,可以结合 LayoutBuilder 计算列数,再传入 GridView 的 delegate。

常见布局问题

如果卡片内容高度不一致,可能出现视觉比例不协调的问题,可以调整 childAspectRatio,或者让子组件内部使用约束控制高度。

如果网格嵌套在其他滚动组件中,需要明确滚动责任,避免多个滚动方向冲突。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 GridView 构建网格页面

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

登录哪都通