화면 방향

화면은 다음의 화면 방향 중 하나에 있거나, 고정될 수 있습니다:

Any

사용자는 기기의 운영체제나 최종 사용자가 허용하는 모든 방향으로 화면을 회전시킬 수 있습니다.

Default (잠금 해제)

화면이 잠금 해제된 상태(즉, 활성화된 방향 잠금이 null인 경우)에 대한 기기의 기본 동작입니다. 이 방향은 기기의 운영체제, 사용자 에이전트, 최종 사용자에 의해 제어되거나, 또는 설치된 웹 애플리케이션에 의해 설정될 수 있습니다. 예를 들어, 화면 방향이 잠금 해제되어 있고 사용자가 기기를 회전시키면, 일부 기기는 방향 변환을 세로-주, 가로-주, 가로-보조로 제한할 수 있지만, 세로-보조로는 변경하지 않습니다.

Landscape

화면의 가로 길이가 세로 길이보다 클 때입니다.

Natural

사용자 에이전트, 사용자, 운영체제 또는 화면 자체에 의해 결정되는 기기 디스플레이의 가장 자연스러운 방향입니다. 예를 들어, 사용자의 손에 쥐어 세워서 화면이 사용자를 바라보도록 한 상태입니다. 컴퓨터 모니터는 일반적으로 가로-주 방향이 자연스럽고, 모바일 기기는 일반적으로 세로-주 방향이 자연스럽습니다.

Portrait

화면의 세로 길이가 가로 길이보다 클 때입니다.

Primary

기기 화면의 자연스러운 세로 또는 가로 방향입니다.

Secondary

기기 화면의 주 세로 또는 가로 방향의 반대입니다.

출력 장치의 화면에는 다음과 같은 개념들이 연관되어 있습니다:

활성화된 방향 잠금

화면이 고정된 화면 방향을 OrientationLockType으로 나타냅니다. 잠금 해제된 경우 null입니다.

현재 방향 각도

화면이 자연스러운 방향으로부터 반시계 방향으로 얼마나 회전되었는지를 도(degree) 단위로 나타냅니다. 이 값은 화면 방향 값 목록에서 도출됩니다.

현재 방향 유형

화면의 화면 방향을 OrientationType으로 나타냅니다.

아래의 화면 방향 값 목록은 서로 다른 자연스러운 방향을 가진 화면에 대하여 각 화면 방향 유형에 대응하는 각도를 표준화합니다:

자연스러운 세로 방향을 가진 화면의 경우:

• portrait-primary: 0°
• landscape-primary: 90°
• portrait-secondary: 180°
• landscape-secondary: 270°

자연스러운 가로 방향을 가진 화면의 경우:

• landscape-primary: 0°
• portrait-primary: 90°
• landscape-secondary: 180°
• portrait-secondary: 270°

Document 인터페이스는 다음과 같은 내부 슬롯으로 확장됩니다:

사전 잠금 조건은 화면 방향 잠금을 허용하기 전에 사용자 에이전트가 MAY 부과할 수 있는 선택적 요구 사항이다. 일반적인 사전 잠금 조건에는 문서가 전체 화면 모드여야 하거나 설치된 웹 애플리케이션의 일부여야 한다는 요구가 포함된다. 구체적인 예시는 10. 웹 애플리케이션 매니페스트와의 상호작용 및 9. Fullscreen API와의 상호작용을 참고하라.

lock() 메서드가 OrientationLockType orientation과 함께 호출되면, 사용자 에이전트는 다음 단계를 MUST 수행해야 한다.

1. document를 this의 관련 전역 객체의 연관된 Document로 둔다.
2. 공통 안전 점검을 document로 실행한다. 예외가 발생하면, 해당 예외로 거부된 프라미스를 반환하고 이 단계들을 중단한다.
3. 사용자 에이전트가 화면 방향을 orientation으로 잠그는 것을 지원하지 않으면, "NotSupportedError" DOMException으로 거부된 프라미스를 반환하고 이 단계들을 중단한다.
4. 사용자 에이전트가 document와 그에 연관된 탐색 문맥이 사전 잠금 조건을 충족해야만 화면 방향을 잠글 수 있도록 요구하며, 그 조건이 충족되지 않은 경우, "NotAllowedError" DOMException으로 거부된 프라미스를 반환하고 이 단계들을 중단한다.
5. document의 [[orientationPendingPromise]]가 null이 아니라면, 현재 잠금 프라미스를 거부하고 무효화한다 document의 "AbortError"로.
6. document의 [[orientationPendingPromise]]를 새 프라미스로 설정한다.
7. 방향 잠금을 적용한다 orientation을 document에.
8. document의 [[orientationPendingPromise]]를 반환한다.

unlock() 메서드가 호출되면, user agent는 MUST 다음 단계를 수행해야 한다:

1. document를 this의 relevant global object의 연관된 Document로 둔다.
2. 공통 안전성 검사를 document에 대해 실행한다. 만약 예외가 throw되면, 해당 예외를 다시 throw하고 이 단계를 중단한다.
3. screen의 활성화된 방향 잠금이 null이면, undefined를 반환한다.
4. document의 [[orientationPendingPromise]]가 null이 아니면, document의 현재 잠금 promise 거부 및 null 처리를 "AbortError"로 실행한다.
5. 방향 잠금 적용 null을 document에 적용한다.

공통 안전성 검사는 Document document에 대해 다음 단계로 이루어진다:

1. 만약 document가 사용자 주의가 있는 최상위 트래버서블의 완전히 활성화된 자손이 아니라면, throw "InvalidStateError" DOMException.
2. 만약 document에 샌드박스된 화면 방향 잠금 탐색 문맥 플래그가 설정되어 있다면, throw "SecurityError" DOMException.
3. 만약 document의 가시성 상태가 "hidden"이면, throw "SecurityError" DOMException.

가져올 때, type 속성은 this의 [[type]]를 반환한다.

가져올 때, angle 속성은 this의 [[angle]]를 반환한다.

browsing context context가 생성될 때, user agent는 MUST 다음을 수행해야 한다:

1. screenOrientation을 context의 연관된 ScreenOrientation로 둡니다.
2. screenOrientation의 [[initialType]] 내부 슬롯을 화면의 현재 방향 타입으로 초기화합니다.
3. screenOrientation의 [[type]] 내부 슬롯을 화면의 현재 방향 타입으로 초기화합니다.
4. screenOrientation의 [[angle]] 내부 슬롯을 화면의 현재 방향 각도로 초기화합니다.

단계에서 현재 잠금 promise를 거부 및 null 처리해야 할 때, Document document와 DOMString exceptionName이 주어지면, user agent는 MUST 다음을 수행해야 한다:

1. Assert: [[orientationPendingPromise]]가 null이 아님을 보장한다.
2. promise를 document의 [[orientationPendingPromise]]로 둔다.
3. 글로벌 태스크를 큐에 추가한다. DOM 조작 태스크 소스에 대해, document의 relevant global object를 사용하여 reject promise (새로운 exceptionName DOMException와 함께) 한다.
4. document의 [[orientationPendingPromise]]를 null로 설정한다.

단계에서 방향 잠금을 적용해야 할 때, OrientationLockType? orientation을 Document document에 적용하려면, user agent는 MUST 다음 단계를 수행해야 한다:

1. 만약 document가 완전히 활성화 상태가 아니게 되고, 병렬로 동작할 때, [[orientationPendingPromise]]가 null이 아니면, 현재 잠금 프라미스를 거부하고 무효화한다 document 에 대하여 "AbortError"와 함께.
2. topDocument를 document의 최상위 트래버서블의 활성 문서로 둔다.
3. descendantDocs를 순서 있는 집합으로, topDocument의 자식 navigable의 활성 문서들을, 있다면, 트리 순서로 포함한다.
4. 각각 doc을 descendantDocs에서 순회:
   1. doc이 document라면 continue.
   2. doc의 [[orientationPendingPromise]] 가 null이면 continue.
   3. 현재 잠금 프라미스를 거부하고 무효화한다 doc에 대해 "AbortError"와 함께.
5. 다음 하위 단계를 병렬로 실행한다:
   1. document가 완전히 활성화 상태가 아니게 되고, document의 [[orientationPendingPromise]] 가 null이 아니라면, 현재 잠금 프라미스를 거부하고 무효화한다 document에 "AbortError"와 함께, 이 단계들을 중단한다.
   2. orientation이 null이면, 화면 방향 잠금을 해제한다.
   3. 그 외의 경우, 화면 방향을 orientation으로 잠그기를 시도한다. 플랫폼의 규칙에 따라, orientation에 맞게 뷰포트 표시 방식을 변경한다.
   4. 만약 기존에 설정된 사용자 환경설정, 플랫폼 제한, 기타 이유로 인해 잠금 시도가 실패하면:
      1. 화면의 활성 화면 방향 잠금을 null로 설정한다.
      2. 작업 큐에 추가를 DOM 조작 작업 소스에서 document의 관련 전역 객체와 함께 처리한다:
         1. document의 [[orientationPendingPromise]] 가 null이 아니면, 현재 잠금 프라미스를 거부하고 무효화한다 document에 대해 "NotSupportedError"와 함께.
         2. 이 단계들을 중단한다.
      Note

      사용자가 웹 애플리케이션이 화면 방향을 변경하는 것을 방지하는 환경설정을 적용했거나, 사용자 에이전트가 아닌 기본 플랫폼에서 해당 orientation으로의 화면 방향 잠금을 허용하지 않는 경우에 이런 일이 발생할 수 있습니다. 사용자 환경설정 혹은 플랫폼 능력치의 차이는 잠금 실패 행동의 패턴을 통해 지문 채집에 악용될 수 있으니 주의가 필요합니다.

   5. 화면의 활성 화면 방향 잠금을 orientation으로 설정하고, 현재 방향 유형과 현재 방향 각도를 화면 방향의 변경 상태를 반영하여 갱신한다.
6. 전역 작업을 큐에 추가를 DOM 조작 작업 소스에서 document의 관련 전역 객체와 함께 처리한다:
   1. promise에 document의 [[orientationPendingPromise]] 값을 대입한다.
      Note
   2. document의 [[orientationPendingPromise]] 를 null로 설정한다.
   3. 화면 방향 변경 단계를 topDocument로 실행한다.
   4. promise가 null이 아니면, resolve promise를 undefined로 해결한다.

사용자 에이전트가 최상위 트래버서블의 화면 방향이 변경되었음을 감지하거나, 사용자가 최상위 브라우징 컨텍스트를 다른 화면으로 이동시키는 경우, 해당 화면 방향 변경 단계를 최상위 트래버서블의 활성 문서와 함께 실행한다.

화면 방향 변경 단계는 Document document에 대해 다음과 같다:

1. document가 사용자 주의가 있는 최상위 트래버서블의 완전히 활성화된 자손이 아니라면, 이 단계를 중단한다.
2. type과 angle을 화면의 현재 방향 유형과 현재 방향 각도로 둔다.
3. screenOrientation을 document의 관련 전역 객체의 연관된 ScreenOrientation로 둔다.
4. type이 screenOrientation의 [[type]]와 같고, angle이 screenOrientation의 [[angle]]와 같다면, 이 단계들을 중단한다.
5. 전역 작업을 큐에 추가한다를 사용자 상호작용 작업 소스에서 document의 관련 전역 객체와 함께 다음 단계를 실행한다:
   1. screenOrientation의 [[angle]]를 angle로 설정한다.
   2. screenOrientation의 [[type]] 를 type로 설정한다.
   3. "change"라는 이벤트를 발생시킨다 screenOrientation에.
6. descendantDocs를 순서 있는 집합으로, document의 자식 navigable의 활성 문서들을, 있다면, 트리 순서로 포함한다.
7. 각각 doc을 descendantDocs에서, 화면 방향 변경 단계를 doc에 대해 실행한다.

[HTML]의 "visibility state 업데이트" 알고리즘은 화면 방향 변경 단계를 실행한다.

unloading document cleanup steps가 document에 대해 실행될 때마다, user agent는 MUST 다음 단계를 실행해야 한다:

1. document가 최상위 트래버서블의 활성 문서가 아니라면, 이 단계들을 중단한다.
2. document와 함께 화면 방향 완전 잠금 해제 단계를 실행한다.

화면 방향 완전 해제 단계는 Document document에 대해 다음과 같다:

1. document의 [[orientationPendingPromise]]가 null이 아니라면, 현재 잠금 프라미스를 거부하고 무효화한다 document에 대해 "AbortError"와 함께.
2. topDocument를 document의 최상위 트래버서블의 활성 문서로 둔다.
3. 방향 잠금 적용 null을 topDocument에 실행한다.

사용자 프라이버시를 보호하기 위해, 방향 변경 이벤트는 여러 전달 제한을 받습니다:

• 이벤트는 문서가 사용자 주의가 있는 최상위 트래버서블의 완전히 활성화된 자손일 때만 발생합니다.
• 추가적인 가시성 상태 검사는 숨겨진 문서에 대한 심층 방어를 제공합니다.
• 이벤트는 활성 문서에서 최상위 트래버서블을 시작으로 하위 문서로 전달됩니다.

문서가 사용자 주의가 있는 최상위 트래버서블의 완전히 활성화된 자손이어야 한다는 요구 사항은 방향 이벤트가 시스템 수준에서 보기 가능하며 사용자의 주의(포커스 또는 키 입력 등)를 받는 윈도우에만 전달되도록 보장합니다. 추가적인 가시성 상태 검사는 심층 방어를 제공합니다. 이러한 제한 덕분에 백그라운드 탭, 숨겨진 창, 최소화된 애플리케이션이 지문 채집 목적의 방향 데이터를 수집하는 것을 방지합니다.

지문 채집을 막기 위해, 사용자 에이전트는 특히 프라이버시에 민감한 환경(예: 비공개 브라우징 모드)에서 다음 보호 기능을 SHOULD 구현해야 합니다:

1. 최상위 트래버서블이 존재하는 동안, 화면의 natural 방향이 [[initialType]]인 것처럼 동작합니다.
2. type getter의 반환값을 "portrait-primary" 또는 "landscape-primary"로 제한합니다. 화면 비율에 따라 둘 중 무엇이 반환될지 결정합니다.
3. 현재 방향 유형이 [[initialType]]과 같으면, angle getter를 위해 0을 반환하고, 그렇지 않으면 90을 반환합니다.
4. 화면 방향이 변경되면, change 이벤트는 현재 방향 유형이 portrait에서 landscape로, 또는 그 반대로 변경될 때만 발생합니다.