스캐폴드: 페인
핵심 구성요소를 조합할 수 있는 표준 플랫폼을 제공하는 기본 UI 디자인 구조
패널
모든 레이아웃은 1~3개의 페인으로 구성됩니다. 선택하는 레이아웃 유형과 페인 수는 브레이크포인트(이전의 창 크기 클래스)와 개발 중인 제품 유형에 따라 결정해야 합니다.

모든 레이아웃은 화면에 표시되는 1~3개의 페인으로 구성됩니다. 선택하는 레이아웃 유형과 페인 수는 브레이크포인트와 개발 중인 제품 유형에 따라 결정해야 합니다.
| 브레이크포인트 | 권장 총 페인 수 | 그 외 총 페인 수 |
|---|---|---|
| 컴팩트 | 1 | -- |
| 미디엄 | 1 | 2 |
| 익스팬디드 | 2 | 1 |
| 라지 | 2 | 1 |
| 엑스트라 라지 | 2 | 1, 3 |
페인의 종류는 다음과 같습니다:
- 고정 페인: 사용 가능한 공간과 관계없이 너비가 변하지 않습니다.
- 유연한 페인: 사용 가능한 공간에 따라 너비가 변하며, 확대되거나 축소될 수 있습니다.
모든 레이아웃에는 유연한 페인이 하나 이상 필요합니다.

- 고정 페인
- 유연한 페인
페인은 영구 페인 또는 임시 페인일 수 있습니다. 임시 페인은 필요할 때 나타나고 닫힐 수 있으며, 다른 페인의 레이아웃과 크기에 영향을 줍니다.

단일 페인 레이아웃
단일 페인 레이아웃은 하나의 유연한 페인으로 구성되며, 해당 페인은 레이아웃 너비 내 사용 가능한 공간에 맞게 확장됩니다. 모든 브레이크포인트에서 사용할 수 있지만, 컴팩트 및 미디엄 브레이크포인트에 권장됩니다.

2페인 레이아웃
분할 페인 레이아웃
분할 페인 레이아웃은 스페이서가 시각적 중심에 유지되도록 설계됩니다. 폴더블 기기와 동적 레이아웃에 가장 적합합니다.
탐색 레일 또는 내비게이션 드로어가 있으면 한 페인만 크기가 줄어들고, 다른 페인은 드로어 너비의 50%를 유지합니다.

내비게이션 바가 있거나 내비게이션이 없는 경우, 기본적으로 두 페인 모두 창 너비의 50%를 차지합니다.

고정 및 유연한 레이아웃
이 레이아웃은 익스팬디드, 라지, 엑스트라 라지 브레이크포인트에서 일반적입니다. 고정 페인과 유연한 페인은 콘텐츠에 가장 적합한 순서로 배치할 수 있습니다.
고정 페인은 흔히 임시로 사용되며, 정보 밀도가 낮은 측면 시트나 목록에 사용됩니다.

- 고정 페인
- 유연한 페인
3페인 레이아웃
흔하지는 않지만, 엑스트라 라지 브레이크포인트에서는 표준 측면 시트를 세 번째 페인으로 사용할 수 있습니다. 측면 시트가 표시되면 확장된 탐색 레일은 계속 표시되거나, 축소된 탐색 레일로 바뀌거나, 완전히 숨겨질 수 있습니다. 페인은 3개를 초과하여 사용하지 마세요.
참고: 이 브레이크포인트에서는 고정 페인 너비를 412dp로 설정하는 것이 권장되지만, 측면 시트의 기본 최대 너비는 400dp입니다.

- 표준 측면 시트는 세 번째 페인으로 사용할 수 있습니다
페인 확장 및 크기 조정
페인은 드래그 핸들을 사용하여 크기를 조정하고 확장하거나 축소할 수 있습니다.
- 분할 페인 레이아웃에서는 두 유연한 페인의 크기를 자유롭게 조정하거나 특정 너비에 맞춰 고정할 수 있습니다.
- 고정 및 유연한 레이아웃에서는 드래그 핸들로 고정 페인을 완전히 축소하거나 확장할 수 있습니다. 이를 통해 단일 페인 레이아웃과 2페인 레이아웃 간에 쉽게 전환할 수 있습니다.
드래그 핸들을 선택하여 레이아웃 크기를 전환할 수도 있습니다. 전환은 탭, 더블 탭 또는 길게 누르기로 수행할 수 있습니다.
익스팬디드, 라지, 엑스트라 라지 브레이크포인트에서 2페인 레이아웃은 크기 조정 시 미리 설정된 너비에 맞춰 고정되도록 사용자 정의할 수 있습니다.
권장 사용자 정의 너비는 다음과 같습니다:
- 360dp
- 412dp
- 스페이서가 시각적 중앙에 위치하는 분할 페인
지속형 페인 크기 조정
지속형 크기 조정 동작은 사용자의 페인 너비 선호도를 기억합니다. 크기 조정이 가능한 대부분의 레이아웃에 사용하세요.
너비는 브레이크포인트가 변경된 후에도 유지됩니다. 예를 들어 2페인 레이아웃을 1페인으로 축소한 경우, 이후 브레이크포인트가 변경되어도 축소된 상태가 유지됩니다.
임시 페인 크기 조정
임시 크기 조정 동작은 사용자의 페인 너비 선호도를 기억하지 않습니다. 주로 크기 조정이 자주 발생하지 않는 보조 페인 레이아웃에서 사용됩니다.
임시 크기 조정을 사용하면 페인이나 앱을 닫았다가 다시 열었을 때 페인은 항상 기본 레이아웃으로 복원되어야 합니다. 이렇게 하면 대부분의 상호작용에서 콘텐츠가 적절한 크기로 유지됩니다.
여러 페인 표시
여러 페인은 동일 평면(co-planar), 플로팅, 도킹의 세 가지 방식으로 표시할 수 있습니다. 레이아웃은 브레이크포인트, 페인의 역할, 사용자가 페인과 상호작용하는 방식에 따라 달라집니다:
- 동일 평면: 두 페인이 나란히 배치됩니다. 접근성을 확보하려면 도구 패널과 같은 항상 표시되는 유틸리티는 기본 콘텐츠와 동일 평면에 있어야 합니다.
- 플로팅: 작은 페인이 더 큰 페인 위에 표시됩니다. 대화상자와 같은 임시 작업은 브레이크포인트에 관계없이 플로팅 상태로 유지되어야 합니다.
- 도킹: 작은 페인이 창 가장자리에 고정됩니다. 예를 들어 바텀 시트를 도킹하여 추가 작업을 표시할 수 있습니다.



페인이 적응하는 방식
페인 레이아웃의 적응 방식에는 표시 및 숨기기, 플로팅 전환, 또는 리플로우의 세 가지 전략이 있습니다. 창 크기가 조정되거나 방향이 바뀌면 이러한 전략을 통해 페인이 재배치되어 맥락과 의미를 유지할 수 있습니다.
표시 및 숨기기
브레이크포인트 크기나 방향이 변경되면 페인이 화면에 나타나거나 사라지거나 서로 나란히 배치될 수 있습니다.
플로팅 전환
페인은 플로팅 또는 도킹 페인으로 다른 콘텐츠 위에 표시될 수 있습니다. 이 전략은 페인이 트리거 요소와 연관된 위치에 표시되도록 돕습니다.
플로팅 페인:
- 본문 콘텐츠 위에 표시됩니다
- 사용자 정의를 통해 드래그하거나 크기를 조정할 수 있습니다
플로팅 페인의 크기를 조정하거나 이동하는 컨트롤을 추가할 때는 접근 가능한 컨트롤을 제공해야 합니다.
대형 화면에서:
- 플로팅 페인이 기본으로 표시됩니다
- 플로팅 페인 뒤의 스크림(배경 가리개)은 선택 사항입니다

- 스크림이 있는 플로팅 페인
- 스크림이 없는 플로팅 페인
도킹 페인은 일반적으로 바텀 시트처럼 창 하단에 있습니다.
미디엄 및 익스팬디드 브레이크포인트에서 도킹 페인은 플로팅 페인으로 전환될 수 있습니다.
또는 미디엄 및 익스팬디드 브레이크포인트에서 도킹 페인은 동일 평면 페인으로 전환될 수 있습니다.
대형 화면에서는 도킹 페인을 동일 평면 페인으로 변경하는 것이 좋습니다.

- 컴팩트 화면에는 도킹 페인이 있을 수 있습니다
- 대형 화면에서는 동일 평면 페인으로 변경되어야 합니다
리플로우
브레이크포인트나 방향이 변경될 때 페인이 화면에서 재배치될 수 있으며, 이를 리플로우라고도 합니다.
예를 들어 세로 모드에서는 보조 페인이 기본 페인 아래로 이동할 수 있습니다.
리플로우는 브레이크포인트에도 적용됩니다. 페인을 배치할 가로 공간이 부족하면 대신 세로로 쌓을 수 있습니다.
공간 패널
XR 기기에서 페인 레이아웃은 분리된 공간 패널로 표시될 수 있습니다. 이러한 패널은 어떤 배경에서도 쉽게 보이도록 명확한 경계(컨테이너)를 갖춰야 합니다.
공간 패널의 콘텐츠는 페인에 환경과 구분되는 명확한 컨테이너가 있을 때 암시적 그룹화를 사용할 수 있습니다.

접근성 고려 사항
동일 평면 페인
- 포커스 순서는 화면에 표시된 페인의 시각적 배치와 일치해야 합니다
플로팅 페인
모달 플로팅 페인:
- 활성화된 동안에는 뒤에 있는 요소와 상호작용할 수 없습니다
- 포커스는 자동으로 페인의 첫 번째 요소로 이동하며, 페인이 닫히면 대화상자처럼 포커스가 페인을 연 요소로 돌아갑니다
- 자동으로 표시된 경우에도 포커스는 해당 페인으로 이동해야 하지만, 페인이 닫히면 포커스는 화면에서 맥락상 가장 적절한 다음 요소로 이동해야 합니다
- 사용자가 뒤에 있는 항목과 상호작용하면 페인이 사라집니다.
비모달 플로팅 페인:
- 열려 있을 때 앱의 다른 영역과 상호작용할 수 있습니다
- 포커스는 페인으로 이동하거나 페인에서 벗어날 수 있어야 합니다
- 페인은 화면의 논리적 읽기 순서에 따라 접근할 수 있어야 합니다
도킹 페인
- 모달 및 비모달 페인과 동일한 포커스 요구 사항을 충족해야 합니다
- 포커스 순서는 화면에 표시된 페인의 시각적 배치와 일치해야 합니다