跨平台开发 / 系统课时

用 MediaQuery 获取屏幕信息

用 MediaQuery 获取屏幕信息

移动设备的屏幕尺寸、方向、安全区域和系统文字缩放都会影响 Flutter 页面布局。本篇将学习如何通过 MediaQuery 读取这些环境数据,并根据设备状态调整界面,让页面在不同手机和平板上保持合理显示。

学习目标

  • 理解 MediaQuery 提供的屏幕环境信息类型和使用场景
  • 掌握读取尺寸、方向、安全区域和文字缩放的方法
  • 能够根据设备环境编写自适应布局逻辑

认识 MediaQuery 提供的环境数据

Flutter 中的布局组件只知道父级给予的空间,而不知道设备整体环境。例如,一个页面可能需要避开刘海区域、根据横竖屏调整排列方式,或者响应系统字体放大设置。这些信息由 MediaQuery 提供。

MediaQuery 会从当前 Widget 树的上下文中读取 MediaQueryData,常用属性包括:

属性 用途
size 获取屏幕可用尺寸
orientation 判断横屏或竖屏
padding 获取系统安全区域边距
viewInsets 获取键盘等遮挡区域
textScaler 获取系统文字缩放比例

页面通常通过 MediaQuery.of(context) 获取这些信息。

获取屏幕尺寸调整布局

最常见的场景是根据屏幕宽度设置不同尺寸。例如列表卡片在手机上占满宽度,在大屏设备上限制最大宽度。

dart
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('自适应宽度内容'),
          ),
        ),
      ),
    );
  }
}

预期输出

text
页面显示一个居中的卡片。
屏幕宽度小于或等于 600 时,卡片占约 90% 宽度。
屏幕宽度大于 600 时,卡片最大宽度保持为 500。

这里的关键不是固定判断某个手机型号,而是根据可用空间决定布局策略。

处理方向、安全区域和系统设置

横竖屏切换时,可以使用 orientation 调整组件排列。例如竖屏显示上下结构,横屏显示左右结构。

dart
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('底部内容')],
  );
}

预期结果

text
竖屏设备显示 Column 布局。
横屏设备显示 Row 布局。

安全区域信息适合处理刘海屏、状态栏和底部手势区域。例如顶部内容需要避开状态栏时,可以结合 SafeArea 或读取 padding。

系统文字缩放也需要关注。用户可能在系统设置中放大字体,如果界面依赖固定高度,可能出现文字溢出。使用 MediaQuery 获取文字缩放信息后,可以设计更灵活的布局。

MediaQuery 的使用边界

MediaQuery 适合获取设备环境信息,但不应该替代所有布局判断。如果问题是“当前父组件给了多少空间”,应优先使用 LayoutBuilder;如果问题是“设备整体环境如何”,才使用 MediaQuery。

例如,一个弹窗内部宽度可能只有屏幕的一半,此时读取屏幕宽度无法准确判断内部布局空间。这个场景应该交给下一节介绍的 LayoutBuilder。

在实际项目中,MediaQuery 通常负责感知设备环境,LayoutBuilder 负责响应组件约束,两者结合可以构建稳定的响应式页面。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 MediaQuery 获取屏幕信息

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

登录哪都通