跨平台开发 / 系统课时
用 MediaQuery 获取屏幕信息
用 MediaQuery 获取屏幕信息
移动设备的屏幕尺寸、方向、安全区域和系统文字缩放都会影响 Flutter 页面布局。本篇将学习如何通过 MediaQuery 读取这些环境数据,并根据设备状态调整界面,让页面在不同手机和平板上保持合理显示。
学习目标
- 理解 MediaQuery 提供的屏幕环境信息类型和使用场景
- 掌握读取尺寸、方向、安全区域和文字缩放的方法
- 能够根据设备环境编写自适应布局逻辑
认识 MediaQuery 提供的环境数据
Flutter 中的布局组件只知道父级给予的空间,而不知道设备整体环境。例如,一个页面可能需要避开刘海区域、根据横竖屏调整排列方式,或者响应系统字体放大设置。这些信息由 MediaQuery 提供。
MediaQuery 会从当前 Widget 树的上下文中读取 MediaQueryData,常用属性包括:
| 属性 | 用途 |
|---|---|
| size | 获取屏幕可用尺寸 |
| orientation | 判断横屏或竖屏 |
| padding | 获取系统安全区域边距 |
| viewInsets | 获取键盘等遮挡区域 |
| textScaler | 获取系统文字缩放比例 |
页面通常通过 MediaQuery.of(context) 获取这些信息。
获取屏幕尺寸调整布局
最常见的场景是根据屏幕宽度设置不同尺寸。例如列表卡片在手机上占满宽度,在大屏设备上限制最大宽度。
import 'package:flutter/material.dart';
class ResponsiveCard extends StatelessWidget {
const ResponsiveCard({super.key});
@override
Widget build(BuildContext context) {
final screenWidth = MediaQuery.of(context).size.width;
final cardWidth = screenWidth > 600 ? 500.0 : screenWidth * 0.9;
return Center(
child: SizedBox(
width: cardWidth,
child: const Card(
child: Padding(
padding: EdgeInsets.all(16),
child: Text('自适应宽度内容'),
),
),
),
);
}
}预期输出
页面显示一个居中的卡片。
屏幕宽度小于或等于 600 时,卡片占约 90% 宽度。
屏幕宽度大于 600 时,卡片最大宽度保持为 500。这里的关键不是固定判断某个手机型号,而是根据可用空间决定布局策略。
处理方向、安全区域和系统设置
横竖屏切换时,可以使用 orientation 调整组件排列。例如竖屏显示上下结构,横屏显示左右结构。
Widget buildContent(BuildContext context) {
final media = MediaQuery.of(context);
if (media.orientation == Orientation.landscape) {
return const Row(
children: [Expanded(child: Text('左侧内容')), Expanded(child: Text('右侧内容'))],
);
}
return const Column(
children: [Text('顶部内容'), Text('底部内容')],
);
}预期结果
竖屏设备显示 Column 布局。
横屏设备显示 Row 布局。安全区域信息适合处理刘海屏、状态栏和底部手势区域。例如顶部内容需要避开状态栏时,可以结合 SafeArea 或读取 padding。
系统文字缩放也需要关注。用户可能在系统设置中放大字体,如果界面依赖固定高度,可能出现文字溢出。使用 MediaQuery 获取文字缩放信息后,可以设计更灵活的布局。
MediaQuery 的使用边界
MediaQuery 适合获取设备环境信息,但不应该替代所有布局判断。如果问题是“当前父组件给了多少空间”,应优先使用 LayoutBuilder;如果问题是“设备整体环境如何”,才使用 MediaQuery。
例如,一个弹窗内部宽度可能只有屏幕的一半,此时读取屏幕宽度无法准确判断内部布局空间。这个场景应该交给下一节介绍的 LayoutBuilder。
在实际项目中,MediaQuery 通常负责感知设备环境,LayoutBuilder 负责响应组件约束,两者结合可以构建稳定的响应式页面。