화면 방향

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

모두

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

기본값 (잠금 해제됨)

화면이 잠금 해제된 경우의 기기 기본 동작 (즉, 활성 방향 잠금이 null인 경우)이다. 이 방향은 기기의 운영 체제나 사용자 에이전트에 의해 결정되거나, 최종 사용자가 제어하거나, 설치된 웹 애플리케이션에 의해 설정될 수도 있다. 예를 들어, 화면 방향의 잠금이 해제된 상태에서 사용자가 기기를 회전하면 일부 기기는 방향 변경을 portrait-primary, landscape-primary 및 landscape-secondary로 제한하지만, portrait-secondary로는 제한하지 않는다.

가로 방향

화면의 가로세로비에서 너비가 높이보다 크다.

자연 방향

사용자 에이전트, 사용자, 운영 체제 또는 화면 자체에 의해 결정되며 방향 각도를 측정하는 기준이 되는 기기 디스플레이의 기준 방향이다. 예를 들어, 컴퓨터 모니터의 기준 방향은 일반적으로 landscape-primary인 반면, 휴대전화의 기준 방향은 일반적으로 portrait-primary이다.

참고

사용자 에이전트가 자연 방향을 결정하는 방법은 구현에 따라 정의되며 플랫폼마다 다르다. 일부 사용자 에이전트는 기기 유형별로 고정된 방향을 사용하고(예: 휴대전화에는 portrait-primary, 태블릿, 데스크톱 및 TV에는 landscape-primary), 다른 사용자 에이전트는 화면의 물리적 크기와 기본 회전으로부터 이를 도출한다. 정사각형 화면이나 폴더블 화면처럼 뚜렷한 직립 방향이 없는 기기에서는 자연 방향이 사용자 에이전트마다 다를 수 있다.

세로 방향

화면의 가로세로비에서 높이가 너비보다 크다.

주 방향

세로 방향 또는 가로 방향에 대한 기기 화면의 자연 방향이다.

보조 방향

세로 방향 또는 가로 방향에 대한 기기 화면의 주 방향과 반대되는 방향이다.

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

활성화된 방향 잠금

화면이 고정된 화면 방향을 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로, 또는 그 반대로 변경될 때만 발생합니다.