跨平台开发 / 系统课时

用 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 列数,详情页可以根据空间决定图片和文字是否并排显示。通过约束驱动布局,可以减少大量设备适配代码。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 LayoutBuilder 适配可用空间

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

登录哪都通