用途:帮助 Flutter 应用构建随可用窗口空间自适应的布局,而非仅针对物理设备。
主要能力与要点: 空间测量:用 MediaQuery.sizeOf(context) 获取整个应用窗口尺寸;用 LayoutBuilder 依据父组件分配空间做布局决策,判断 constraints.maxWidth。不要在组件树顶部用 MediaQuery.orientationOf 或 OrientationBuilder 切换布局,设备方向不能准确反映可用窗口空间;也不要按硬件类型(手机/平板)判断,应严格基于可用窗口空间。 尺寸与约束:遵循“约束向下传递、尺寸向上传递、父级决定位置”。在 Row、Column、Flex 中用 Expanded 填满剩余空间,用 Flexible 配合 flex 因子按比例分配。大屏上用 ConstrainedBox 或 Container 设置 maxWidth 限制 GridView、ListView 宽度。列表项多或未知时用 ListView.builder 或 GridView.builder 懒加载。 设备与方向:不要锁定屏幕方向,否则在折叠设备上易出现黑边;Android 大屏需同时支持横竖屏。若业务必须锁定方向,用 Display API 获取物理屏幕尺寸而非 MediaQuery。同时支持鼠标、触控板与键盘快捷键,保证触控目标尺寸与键盘导航可用。
使用方式:将目标组件包在 LayoutBuilder 中,取 constraints.maxWidth,设定断点(如 largeScreenMinWidth = 600);大于断点返回大屏布局(如 Row 并排导航栏与内容区),否则返回小屏布局。大屏优化时,把全宽组件包进 ConstrainedBox 并设 BoxConstraints(maxWidth: 800.0),再包 Center 居中;列表可改用 GridView.builder 配合 SliverGridDelegateWithMaxCrossAxisExtent 自动调整列数。完成后调整窗口验证过渡并修复溢出。
适用场景:需要同时适配手机、平板、桌面、折叠屏与多窗口模式的 Flutter 界面。
限制:资料未提供具体收费、平台支持范围或性能数据,暂未提供。