news 2026/5/28 9:33:16

Flutter + OpenHarmony 网格布局:GridView 与 SliverGrid 在鸿蒙设备内容展示中的应用

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Flutter + OpenHarmony 网格布局:GridView 与 SliverGrid 在鸿蒙设备内容展示中的应用


个人主页:

文章目录

    • 前言
  • 基础组件——GridView 组件
    • 作用/特点
    • 常见属性
    • 代码示例
  • 基础组件——SliverGrid 组件
    • 作用/特点
    • 常见属性
    • 代码示例
    • 面向 OpenHarmony 的工程建议
  • 结语

注:本文所有实践均基于手机端场景,适用于 OpenHarmony 手机设备的应用开发。

前言

在 OpenHarmony 手机应用开发中,网格布局是展示图片、商品、功能入口等内容的常用方式。Flutter 提供了GridViewSliverGrid两种核心组件,分别适用于简单独立页面和复杂滚动联动场景。本文将从基础出发,系统介绍二者的作用、常见属性,并提供可直接运行的手机端代码示例。


基础组件——GridView 组件

作用/特点

GridView是 Flutter 中用于构建二维滚动列表的基础组件。它适用于独立的网格页面,如相册、应用图标列表、商品橱窗等。其特点是:

  • 使用简单,开箱即用;
  • 支持垂直或水平滚动;
  • 可通过gridDelegate灵活控制列数与子项比例;
  • 默认使用ListView的底层机制,具备良好的性能表现。

常见属性

属性类型说明
scrollDirectionAxis滚动方向,默认Axis.vertical
reversebool是否反转滚动方向
paddingEdgeInsetsGeometry?内边距
gridDelegateSliverGridDelegate控制网格布局规则(必填)
children/itemBuilder+itemCount子项数据源(推荐使用builder形式)
cacheExtentdouble可视区域外预加载距离,提升滚动流畅度
physicsScrollPhysics?滚动物理效果,手机默认为ClampingScrollPhysics
shrinkWrapbool是否包裹内容高度(嵌套时使用,否则影响性能)

⚠️ 手机端建议:始终使用GridView.builder,避免一次性构建所有子项;若子项高度一致,可配合固定childAspectRatio提升性能。

代码示例

// grid_view_demo_phone.dartimport'package:flutter/material.dart';voidmain()=>runApp(constMyApp());classMyAppextendsStatelessWidget{constMyApp({super.key});@overrideWidgetbuild(BuildContextcontext){returnMaterialApp(title:'GridView 手机示例',home:Scaffold(appBar:AppBar(title:constText('GridView - 商品列表')),body:GridView.builder(itemCount:40,gridDelegate:constSliverGridDelegateWithFixedCrossAxisCount(crossAxisCount:2,// 手机常用 2 列childAspectRatio:0.85,// 宽略大于高mainAxisSpacing:12,crossAxisSpacing:12,),cacheExtent:600,itemBuilder:(context,index){return_buildGridItem('商品$index');},),),);}staticWidget_buildGridItem(Stringtitle){returnCard(clipBehavior:Clip.hardEdge,child:Column(crossAxisAlignment:CrossAxisAlignment.stretch,children:[AspectRatio(aspectRatio:1.0,child:Container(color:Colors.grey[300]),),Padding(padding:constEdgeInsets.all(8),child:Text(title,textAlign:TextAlign.center,maxLines:1,overflow:TextOverflow.ellipsis,style:constTextStyle(fontSize:14),),),],),);}}

运行界面:

基础组件——SliverGrid 组件

作用/特点

SliverGrid不是独立 Widget,而是CustomScrollView中的一种sliver(可滑动片段)。它适用于需要与其他滚动元素联动的复杂页面,例如:

  • 顶部大图 Banner + 网格内容;
  • 可折叠的 AppBar + 网格列表;
  • 多类型混合滚动(文本 + 网格 + 分割线)。

其核心优势在于:统一滚动上下文,实现无缝联动与高性能滚动

常见属性

属性类型说明
delegateSliverChildDelegate子项构建方式,常用SliverChildBuilderDelegate
gridDelegateSliverGridDelegateGridView,控制列数与比例
keyKey?建议提供稳定 Key,避免重建
findChildIndexCallbackChildIndexGetter?大数据集优化(配合ValueKey使用)

⚠️ 注意:SliverGrid必须作为CustomScrollView的直接子项(sliver),不能单独使用。

代码示例

// sliver_grid_demo_phone.dartimport'package:flutter/material.dart';voidmain()=>runApp(constMyApp());classMyAppextendsStatelessWidget{constMyApp({super.key});@overrideWidgetbuild(BuildContextcontext){returnMaterialApp(title:'SliverGrid 手机示例',home:Scaffold(body:CustomScrollView(slivers:[constSliverAppBar(title:Text('应用中心'),pinned:true,expandedHeight:180,flexibleSpace:FlexibleSpaceBar(background:DecoratedBox(decoration:BoxDecoration(color:Colors.blue,image:DecorationImage(image:NetworkImage('https://picsum.photos/seed/banner/800/400'),//顶部风景图,可替换fit:BoxFit.cover,),),),),),SliverGrid(delegate:SliverChildBuilderDelegate((context,index){return_buildGridItem('App$index');},childCount:30,),gridDelegate:constSliverGridDelegateWithFixedCrossAxisCount(crossAxisCount:4,// 手机图标常用 4 列childAspectRatio:1.0,// 正方形mainAxisSpacing:10,//控制网格横向间距crossAxisSpacing:10,//控制网格纵向间距),),],),),);}staticWidget_buildGridItem(Stringtitle){returnCard(child:Column(mainAxisAlignment:MainAxisAlignment.center,children:[Icon(Icons.apps_outlined,size:32,color:Colors.grey[700]),constSizedBox(height:4),Text(title,textAlign:TextAlign.center,maxLines:1,overflow:TextOverflow.ellipsis,style:constTextStyle(fontSize:12),),],),);}}

运行界面:

面向 OpenHarmony 的工程建议

  1. 动态列数策略
    不要硬编码 crossAxisCount,应根据屏幕宽度计算:
intgetColumnCount(double width){if(width>1200)return6;// 智慧屏if(width>800)return4;// 平板return2;// 手机}

2.图片加载必须优化

  • 使用 cached_network_image,并指定 width/height 或 fit,防止重排。

3.智慧屏交互适配

  • 增大点击区域(≥48dp)
  • 添加焦点高亮(focusColor 或边框)
  • 减少每屏信息量,避免视觉疲劳

4.性能监控常态化

  • 使用 Flutter DevTools 检查
  • Frame time(目标 <16ms)
  • Memory usage(滚动时平稳)
  • Widget rebuilds(网格项无意外重建)

结语

在 OpenHarmony 手机应用开发中,GridViewSliverGrid各有其适用场景:前者简洁高效,适合独立内容展示;后者灵活强大,适用于需与 AppBar、Banner 等组件联动的复杂滚动页面。只要合理使用builder模式、固定子项比例、控制预加载范围,即可在手机端实现流畅、低内存占用的网格体验。

本文提供的两套完整示例代码,已覆盖日常开发中的主流需求,可直接集成至项目并快速迭代。掌握这两种网格布局方式,是构建高质量 Flutter 应用的重要基础。

🔜下期预告:《Flutter + OpenHarmony 用户输入框:TextField 与 InputDecoration 在多端表单中的交互设计》
我们将深入探讨如何在 OpenHarmony 手机上打造安全、易用、美观的输入体验,涵盖焦点管理、键盘适配、校验反馈与样式定制等实战技巧。敬请期待!

欢迎加入开源鸿蒙跨平台社区: https://openharmonycrossplatform.csdn.net

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/5/20 16:54:25

flash-attention总是安装失败

大家有时候在执行下面命令安装flash-attention的时候经常会报错pip install flash-attn --no-build-isolation遇到这种情况&#xff0c;可以从源码进行安装git clone https://github.com/Dao-AILab/flash-attention.git cd flash-attention # RTX 4090的话就是8.9 export TORCH…

作者头像 李华
网站建设 2026/5/21 0:38:13

STM32 HAL库 BMP280气压计读取

BMP280 是一款由博世&#xff08;Bosch&#xff09;推出的高精度气压和温度传感器模块&#xff0c;常用于气象监测、高度计、无人机等应用。 工作电压&#xff1a;模块通常支持 3.3V–5.5V 供电&#xff08;部分资料指出芯片本身为 1.71V–3.6V&#xff0c;但模块已集成电平转换…

作者头像 李华
网站建设 2026/5/20 12:30:05

全网最全8个一键生成论文工具,专科生轻松搞定毕业论文!

全网最全8个一键生成论文工具&#xff0c;专科生轻松搞定毕业论文&#xff01; AI 工具让论文写作不再难 随着人工智能技术的不断发展&#xff0c;越来越多的专科生开始借助 AI 工具来完成毕业论文的撰写。这些工具不仅能够有效降低 AIGC 率&#xff0c;还能在保持语义通顺的…

作者头像 李华
网站建设 2026/5/23 14:40:57

Git行尾符战争:如何彻底解决CRLF与LF的跨平台噩梦

目录 前言1 问题现象&#xff1a;那些令人困惑的Git警告1.1 典型的警告信息1.2 相关错误现象 2 问题本质&#xff1a;CRLF与LF的历史渊源2.1 技术背景解析2.2 Git的智能处理机制2.3 核心配置参数&#xff1a;core.autocrlf 3 根本原因&#xff1a;为什么会出现这个问题&#xf…

作者头像 李华