MediaQuery — 개념, 작동 원리 및 반응형 레이아웃

MediaQuery란

MediaQuery는 애플리케이션의 미디어 환경에 대한 데이터를 제공하는 Flutter의 위젯이자 클래스입니다. MediaQuery는 전체 애플리케이션을 루트 MaterialApp 또는 CupertinoApp 위젯으로 감싸며, 모든 하위 위젯은 MediaQuery.of(context)를 통해 이 데이터에 액세스할 수 있습니다.

Flutter가 애플리케이션을 시작하면 현재 기기의 모든 메트릭을 포함하는 MediaQueryData 인스턴스를 생성합니다. 이 데이터는 기기 회전, 창 크기 변경(데스크톱), 키보드 표시, 시스템 접근성 설정 변경 등 변경 사항에 따라 자동으로 업데이트됩니다. MediaQuery는 데이터 변경 시 위젯 하위 트리를 재구성하여 반응형 인터페이스 적응을 제공합니다.

MediaQueryData에는 다음이 포함됩니다: size(화면 크기), devicePixelRatio(픽셀 밀도), textScaleFactor(시스템 설정의 글꼴 배율), viewInsets(키보드로 덮인 영역), viewPadding(시스템 여백), orientation(방향), platformBrightness(밝은 테마 또는 어두운 테마).

요약: MediaQuery는 Flutter에서 기기 정보의 중앙 소스입니다. MediaQuery.of(context)에 액세스하는 것은 반응형 인터페이스를 구축하는 첫 번째 단계입니다.

MediaQueryData의 주요 속성

MediaQueryData에는 수십 개의 속성이 있지만 가장 많이 사용되는 것은 레이아웃 구성에 영향을 미치는 속성입니다. 주요 속성을 살펴보겠습니다.

Size — 화면 크기

MediaQuery.of(context).size는 기기 독립적 픽셀(dip) 단위의 화면 너비와 높이를 가진 Size 객체를 반환합니다. 이 값들은 시스템 여백을 고려하지 않습니다. 반응형 레이아웃 계산에서 size는 주요 메트릭이며 모바일, 태블릿, 데스크톱 레이아웃의 중단점을 결정합니다.

ViewPadding — 시스템 여백

ViewPadding은 시스템이 상태 표시줄, 노치(화면 컷아웃), 시스템 탐색 패널, 홈 표시기(iOS)를 위해 예약하는 여백입니다. 이러한 여백을 고려하지 않으면 콘텐츠가 시스템 요소 아래에 표시될 수 있습니다. MediaQuery.of(context).padding은 페이지의 루트 컨테이너에 패딩으로 적용해야 하는 EdgeInsets를 반환합니다.

ViewInsets — 키보드 영역

ViewInsets은 소프트웨어 키보드로 덮인 화면 영역입니다. 입력 필드의 경우 키보드 위로 콘텐츠를 올리기 위해 viewInsets.bottom을 모니터링하는 것이 중요합니다. Flutter는 스캐폴드에서 이를 자동으로 처리하지만 사용자 정의 레이아웃의 경우 MediaQuery.of(context).viewInsets을 직접 사용해야 합니다.

Orientation — 기기 방향

Orientation — 세로(portrait) 또는 가로(landscape) 방향. 너비와 높이를 비교하여 결정됩니다: 너비가 높이보다 작으면 세로, 그렇지 않으면 가로입니다. 프로덕션 코드에서 방향은 요소의 세로 및 가로 배열 간 전환에 사용됩니다.

요약: 네 가지 주요 속성(size, viewPadding, viewInsets, orientation)이 반응형 디자인 작업의 90%를 커버합니다. 나머지 속성(textScaleFactor, platformBrightness, devicePixelRatio)은 특정 시나리오에 사용됩니다.

반응형 레이아웃을 위한 MediaQuery 사용

MediaQuery는 Flutter에서 반응형 디자인의 기초입니다. 이를 통해 중단점을 결정하고 화면 크기에 따라 레이아웃을 전환하며 다양한 기기에 맞게 여백을 조정합니다.

일반적인 시나리오: 모바일 앱이 제품 목록을 표시해야 합니다. 휴대폰(너비 < 600dp)에서는 1열, 태블릿(너비 600–900dp)에서는 2열, 데스크톱(너비 > 900dp)에서는 3열입니다. MediaQuery.of(context).size.width를 사용하면 폼 팩터별로 별도의 화면 없이 동적으로 열 수를 선택할 수 있습니다.

두 번째 시나리오: 최신 기기에서 시스템 제스처 인셋 고려. Dynamic Island가 장착된 iPhone 또는 제스처 탐색이 있는 Android에서는 시스템 여백이 화면의 일부를 차지합니다. MediaQuery.of(context).padding은 각 기기 유형에 대해 올바른 값을 반환하며 Scaffold는 body를 통해 자동으로 적용합니다. 사용자 정의 위젯의 경우 MediaQuery에서 패딩을 명시적으로 전달해야 합니다.

세 번째 시나리오: 시스템 접근성 설정에 적응. MediaQuery.of(context).textScaleFactor는 사용자가 설정에서 글꼴 크기를 얼마나 늘렸는지 보여줍니다. textScaleFactor > 1.3에서는 긴 텍스트가 카드 경계를 넘어 레이아웃이 깨질 수 있습니다. 반응형 레이아웃은 이를 고려하고 필요한 경우 더 간단한 레이아웃으로 전환해야 합니다.

요약: MediaQuery는 단순한 메트릭 소스가 아니라 진정한 반응형 인터페이스를 구축하기 위한 도구입니다. 중단점, 안전 영역 및 접근성 고려 사항에 사용하세요.

MediaQuery 코드 예제

예제 1은 화면 크기를 가져오고 중단점을 적용하여 열 수를 선택하는 방법을 보여줍니다.

int getColumnCount(BuildContext context) {
  final width = MediaQuery.of(context).size.width;
  if (width > 900) return 3;
  if (width > 600) return 2;
  return 1;
}

위 예제는 화면 너비에 따라 열 수를 선택하는 함수를 보여줍니다. 중단점 600과 900은 휴대폰, 태블릿, 데스크톱에 대해 일반적으로 허용되는 Material Design 표준에 해당합니다.

예제 2 — 시스템 여백을 고려한 올바른 콘텐츠 배치를 위한 viewPadding과 MediaQuery 사용.

Widget build(BuildContext context) {
  final padding = MediaQuery.of(context).padding;

  return Padding(
    padding: EdgeInsets.only(
      top: padding.top,
      left: padding.left,
      right: padding.right,
    ),
    child: const MyContent(),
  );
}

이 예제에서 padding은 시스템 여백을 사용하여 콘텐츠를 Padding으로 감쌉니다. top은 상태 표시줄과 노치를, left/right는 안전 영역을 고려합니다. Scaffold가 일반적으로 하단 탐색을 자체 처리하므로 bottom은 포함되지 않습니다.

예제 3 — 방향 결정 및 요소 배열 전환.

Widget build(BuildContext context) {
  final isPortrait = MediaQuery.of(context).orientation == Orientation.portrait;

  return isPortrait
      ? const Column(
          children: [HeaderBanner(), ContentList()],
        )
      : const Row(
          children: [HeaderBanner(), ContentList()],
        );
}

세로 모드에서는 요소가 세로로(Column) 배열되고 가로 모드에서는 가로로(Row) 배열됩니다. 이 접근 방식은 기기를 회전할 때 공간을 최대한 활용합니다.

요약: MediaQuery는 반응형 레이아웃을 구축하는 주요 도구입니다. Flutter 인터페이스를 개발할 때 항상 시스템 여백, 중단점 및 방향을 고려하세요.

MediaQuery 사용 시 흔한 실수

실수 1: MediaQuery가 설정되지 않은 컨텍스트에서 MediaQuery.of(context) 호출. 위젯이 트리에서 MediaQuery 위에 있으면 호출이 런타임 오류를 발생시킵니다. 해결책: MediaQuery가 루트 위젯으로 설정된 MaterialApp 또는 CupertinoApp으로 감싸진 위젯 내에서 항상 MediaQuery.of(context)를 호출하세요.

실수 2: 안전 영역을 잊는 것. 개발자는 시스템 여백을 고려하지 않고 MediaQuery.size를 사용하여 요소를 배치합니다. 노치나 제스처 탐색이 있는 기기에서 콘텐츠가 상태 표시줄 아래에 표시됩니다. 해결책: 위치 좌표에서 MediaQuery.of(context).padding을 빼세요.

실수 3: 크기에 대한 고정 바인딩. MediaQuery.of(context).size.width를 사용하여 요소의 정확한 크기를 설정하는 것(width: size.width * 0.3)은 동일한 폼 팩터의 기기에서만 작동합니다. 데스크톱이나 태블릿에서는 레이아웃이 부자연스러워 보입니다. 해결책: 고정 백분율 대신 Expanded 및 Flexible과 함께 중단점을 사용하여 유연한 레이아웃을 만드세요.

실수 4: textScaleFactor 무시. 사용자가 시스템 글꼴을 늘리면 텍스트가 컨테이너 경계를 넘어 인터페이스가 깨질 수 있습니다. 해결책: MediaQuery.of(context).textScaleFactor를 확인하고 1.3 이상의 값에서는 스크롤이 있는 더 간단한 레이아웃으로 전환하세요.

요약: MediaQuery는 강력하지만 미묘한 도구입니다. 모든 기기에서 인터페이스가 올바르게 표시되도록 시스템 여백, 방향 및 접근성 설정을 고려하세요.