跨平台开发 / 系统课时
用 GridView 构建网格页面
用 GridView 构建网格页面
本篇解决 Flutter 中重复元素网格展示的问题,通过 GridView 配置列数、间距和动态构建方式,实现商品列表、图片宫格等常见页面结构。
学习目标
- 理解 GridView 的网格布局机制和常用构造方式
- 掌握通过 delegate 配置列数、间距和子项生成逻辑
- 能够根据实际页面需求选择合适的 GridView 用法
理解 GridView 的布局特点
列表布局通常是一维排列,而网格布局需要同时处理行和列。Flutter 的 GridView 通过 SliverGrid 系列布局算法,将子组件按照固定规则排列到二维空间中。
常见场景包括商品卡片、相册、分类入口和仪表盘模块。相比手动使用 Row 与 Column 组合,GridView 可以自动处理滚动、复用和动态数量变化。
使用 GridView.builder 创建动态网格
当网格数据来自接口或本地列表时,推荐使用 GridView.builder。它不会一次创建所有子组件,而是在滚动过程中按需构建,更适合长列表场景。
下面示例创建一个两列商品卡片布局:
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])),
);
},
),
);
}
}预期结果
页面显示一个可滚动网格。
每行包含 2 个商品卡片。
卡片之间存在水平和垂直间距。配置网格尺寸参数
SliverGridDelegateWithFixedCrossAxisCount 是最常用的固定列数方案,主要参数如下:
| 参数 | 作用 |
|---|---|
| crossAxisCount | 横向排列数量 |
| mainAxisSpacing | 行之间的间距 |
| crossAxisSpacing | 列之间的间距 |
| childAspectRatio | 子项宽高比例 |
如果希望根据屏幕宽度自动变化列数,可以使用 SliverGridDelegateWithMaxCrossAxisExtent,通过设置单个子项最大宽度,让 Flutter 自动计算列数。
选择合适的 GridView 方式
固定分类入口、首页宫格等布局通常提前知道结构,可以直接使用 GridView.count。
数据数量动态变化或可能较多时,应优先使用 GridView.builder,避免无意义的组件创建。
需要响应不同屏幕宽度时,可以结合 LayoutBuilder 计算列数,再传入 GridView 的 delegate。
常见布局问题
如果卡片内容高度不一致,可能出现视觉比例不协调的问题,可以调整 childAspectRatio,或者让子组件内部使用约束控制高度。
如果网格嵌套在其他滚动组件中,需要明确滚动责任,避免多个滚动方向冲突。