개요

fullscreen 지시어는 Element.requestFullscreen()으로 요소를 전체 화면 모드로 전환할 수 있는지를 제어합니다. 기본 허용 목록은 self이며, 교차 오리진 iframe이 전체 화면으로 들어가려면 명시적 위임이 필요합니다.

자세히

`fullscreen=*`는 모든 오리진, `fullscreen=(self)`는 자기 오리진, `fullscreen=()`는 전면 차단, `fullscreen=(self "https://video.example.com")`는 지정 오리진에 위임합니다. iframe이 전체 화면을 쓰려면 `<iframe allow="fullscreen">`(구식 allowfullscreen 속성의 현대적 대체)를 지정합니다. 정책이 거부하면 requestFullscreen()이 반환하는 Promise는 TypeError 또는 거부로 실패하고 전체 화면 전환이 일어나지 않습니다.

과거 일부 브라우저는 fullscreen의 기본 허용 목록을 *로 두었으나 현재 표준은 self로 수렴했습니다. requestFullscreen()은 대개 사용자 제스처(클릭 등) 안에서 호출되어야 성공하며, 이는 정책과 별개의 요건입니다. 구형 Feature-Policy의 fullscreen 및 iframe의 allowfullscreen 속성을 대체·통합합니다.

문법

Permissions-Policy: fullscreen=(self)

실무 참고

• 동영상 임베드가 전체 화면을 지원하게 하려면 iframe에 allow="fullscreen"을 지정하세요(과거의 allowfullscreen 대체).
• 전체 화면 요청은 사용자 제스처 안에서 호출해야 하며, 그렇지 않으면 정책 허용과 무관하게 거부될 수 있습니다.

관련 지시어