跨平台开发 / 系统课时
用 LayoutBuilder 适配可用空间
用 LayoutBuilder 适配可用空间
本篇解决 Flutter 页面在不同尺寸设备上的布局适配问题,通过 LayoutBuilder 获取父组件提供的空间约束,根据可用宽度动态调整页面结构。
学习目标
- 理解 Flutter 约束驱动布局中的父子关系
- 掌握 LayoutBuilder 获取尺寸信息的方法
- 能够根据屏幕空间切换不同布局方案
理解 LayoutBuilder 的作用
Flutter 布局不是组件主动获取屏幕大小,而是父组件向子组件传递约束,子组件根据约束决定自己的尺寸。
LayoutBuilder 提供了访问父级约束的入口,可以根据最大宽度、高度等信息选择不同 Widget 组合。
典型应用包括手机与平板使用不同首页结构、横竖屏切换布局,以及响应式后台页面。
使用 LayoutBuilder 根据宽度调整页面
下面示例根据可用宽度决定使用单列还是双列布局:
dart
import 'package:flutter/material.dart';
class ResponsivePage extends StatelessWidget {
const ResponsivePage({super.key});
@override
Widget build(BuildContext context) {
return Scaffold(
body: LayoutBuilder(
builder: (context, constraints) {
final isWide = constraints.maxWidth >= 600;
if (isWide) {
return Row(
children: const [
Expanded(child: Text('左侧导航')),
Expanded(child: Text('内容区域')),
],
);
}
return const Column(
children: [
Text('移动端单列布局'),
Text('内容区域'),
],
);
},
),
);
}
}预期结果
text
宽度达到 600 像素时显示横向双区域布局。
宽度小于 600 像素时显示单列布局。根据约束设计响应式布局
LayoutBuilder 提供的是父组件可用空间,不一定等于整个屏幕尺寸。例如,一个页面中的侧边栏、弹窗或嵌套容器都会改变子组件实际获得的约束。
因此响应式判断通常应该基于 constraints.maxWidth,而不是直接读取屏幕宽度。
常见判断方式:
| 场景 | 布局策略 |
|---|---|
| 小屏手机 | 单列内容 |
| 大屏手机或平板 | 多列内容 |
| 横屏桌面窗口 | 侧栏加内容区 |
与 MediaQuery 的区别
MediaQuery 更适合获取设备整体信息,例如屏幕尺寸、安全区域和系统字体缩放。
LayoutBuilder 更关注当前组件实际能使用多少空间,因此更适合组件级响应式设计。
如果一个组件需要在不同父容器中复用,优先考虑 LayoutBuilder;如果需要了解设备环境,则使用 MediaQuery。
避免过度依赖固定尺寸
响应式布局的关键不是为每个设备写一套界面,而是根据约束选择合理结构。
例如商品列表可以根据宽度改变 GridView 列数,详情页可以根据空间决定图片和文字是否并排显示。通过约束驱动布局,可以减少大量设备适配代码。
按自己的节奏,确认真正理解。