SafeArea
SafeArea(세이프에어리어) 위젯은 자식 위젯을 노치·상태바·홈 인디케이터 같은 시스템 UI 영역을 피해 화면의 안전한 영역 안에 배치하는 레이아웃 위젯입니다.
기기마다 다른 화면 외곽 침범 영역을 자동으로 피해 주요 콘텐츠가 가려지지 않도록 합니다.
정의 / 역할
SafeArea 위젯은 자식을 미디어 안전 여백(상태바·노치·홈 인디케이터 등)만큼 안쪽으로 밀어 배치합니다. 위·아래·왼쪽·오른쪽 방향별로 적용 여부를 끌 수 있고, 안전 영역이 없을 때 적용할 최소 여백을 지정할 수 있습니다.
- 카테고리: Layouts (레이아웃)
- 기본 적용 방향: 위·아래·왼쪽·오른쪽 모두 켜짐
- 기본 최소 여백:
0
기능
| 기능 | 설명 |
|---|---|
| 안전 영역 배치 | 자식을 노치·상태바·홈 인디케이터 등 시스템 UI를 피한 영역에 배치합니다. |
| 방향별 적용 | 위·아래·왼쪽·오른쪽 각 방향의 여백 적용 여부를 개별로 켜고 끕니다. |
| 최소 여백 | 시스템 안전 영역이 없을 때 적용할 최소 여백(minimum)을 지정합니다. |
| 하단 패딩 유지 | 키보드 등으로 하단 뷰 패딩이 바뀌어도 하단 여백을 유지할지 설정합니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Layouts 카테고리를 엽니다.
- SafeArea 항목을 캔버스로 끌어다 놓습니다.
- 안전 영역 안에 배치할 위젯을 SafeArea 안에 넣습니다.
- 필요하면 방향별 적용 여부(
top·bottom·left·right)와 최소 여백(minimum)을 조정합니다.
속성 (Property)
| 속성 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
left | 왼쪽 안전 영역만큼 안쪽 여백을 적용할지 여부 | 켜짐(true) | 참/거짓 |
top | 위쪽(상태바·노치) 안전 영역만큼 안쪽 여백을 적용할지 여부 | 켜짐(true) | 참/거짓 |
right | 오른쪽 안전 영역만큼 안쪽 여백을 적용할지 여부 | 켜짐(true) | 참/거짓 |
bottom | 아래쪽(홈 인디케이터 등) 안전 영역만큼 안쪽 여백을 적용할지 여부 | 켜짐(true) | 참/거짓 |
minimum | 시스템 안전 영역이 없을 때 적용할 최소 안쪽 여백 | 0 | 여백 값 |
maintainBottomViewPadding | 키보드 등으로 하단 뷰 패딩이 소비돼도 하단 여백을 유지할지 여부 | 켜짐(true) | 참/거짓 |
주의 / 팁
팁
top·bottom·left·right로 방향별로 안전 영역 적용을 끌 수 있습니다. 예를 들어 상단만 적용하려면 나머지 방향을 끕니다.
경고
minimum은 시스템 안전 영역이 더 작을 때만 최소값으로 적용됩니다. 안전 영역이 더 크면 그 값이 우선합니다.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 SafeArea (세이프에어리어) Widget Control 문서에서 확인하세요.