전체 화면 환경 만들기

몰입형 전체 화면 웹사이트와 애플리케이션을 쉽게 만들 수 있지만, 웹의 다른 모든 것과 마찬가지로 몇 가지 방법이 있습니다. 이는 전체 화면을 실행하는 '설치된 웹 앱' 환경을 지원하는 브라우저가 많아진 지금 특히 중요합니다.

앱 또는 사이트를 전체 화면으로 전환하기

사용자 또는 개발자가 웹 앱을 전체 화면으로 표시하는 방법에는 여러 가지가 있습니다.

  • 사용자 동작에 대한 응답으로 브라우저가 전체 화면으로 전환되도록 요청합니다.
  • 홈 화면에 앱을 설치합니다.
  • 가짜: 주소 표시줄을 자동으로 숨깁니다.

사용자 동작에 대한 응답으로 브라우저가 전체 화면으로 전환되도록 요청합니다.

모든 플랫폼이 동일하지는 않습니다. iOS Safari에는 전체 화면 API가 없지만 Android, Firefox, IE 11 이상에서 Chrome에는 있습니다. 빌드하는 대부분의 애플리케이션은 JS API와 전체 화면 사양에서 제공하는 CSS 선택기를 조합하여 사용합니다. 전체 화면 환경을 빌드할 때 주의해야 할 기본 JS API는 다음과 같습니다.

  • element.requestFullscreen() (현재 Chrome, Firefox, IE에서 접두사로 사용됨)는 요소를 전체 화면 모드로 표시합니다.
  • document.exitFullscreen() (현재 Chrome, Firefox, IE에서 접두사로 사용됨) Firefox는 대신 cancelFullScreen() 사용)는 전체 화면 모드를 취소합니다.
  • document.fullscreenElement (현재 Chrome, Firefox, IE에서 접두사로 사용됨)는 요소가 전체 화면 모드인 경우 true를 반환합니다.

앱이 전체 화면인 경우 브라우저의 UI 컨트롤을 더 이상 사용할 수 없습니다. 이렇게 하면 사용자가 환경과 상호작용하는 방식이 변경됩니다. 앞으로, 뒤로와 같은 표준 탐색 컨트롤이 없으며, 새로고침 버튼이라는 탈출구도 없습니다. 이 시나리오에 대비하는 것이 중요합니다. 일부 CSS 선택자를 사용하면 브라우저가 전체 화면 모드로 전환될 때 사이트의 스타일과 표시를 변경할 수 있습니다.

<button id="goFS">Go fullscreen</button>
<script>
  var goFS = document.getElementById('goFS');
  goFS.addEventListener(
    'click',
    function () {
      document.body.requestFullscreen();
    },
    false,
  );
</script>

위의 예는 약간 인위적입니다. 공급업체 접두사 사용과 관련된 모든 복잡성을 숨겼습니다.

실제 코드는 훨씬 더 복잡합니다. Mozilla는 전체 화면을 전환하는 데 사용할 수 있는 매우 유용한 스크립트를 만들었습니다. 보시다시피 공급업체 프리픽스 상황은 지정된 API에 비해 복잡하고 번거롭습니다. 아래의 약간 단순화된 코드에서도 여전히 복잡합니다.

function toggleFullScreen() {
  var doc = window.document;
  var docEl = doc.documentElement;

  var requestFullScreen =
    docEl.requestFullscreen ||
    docEl.mozRequestFullScreen ||
    docEl.webkitRequestFullScreen ||
    docEl.msRequestFullscreen;
  var cancelFullScreen =
    doc.exitFullscreen ||
    doc.mozCancelFullScreen ||
    doc.webkitExitFullscreen ||
    doc.msExitFullscreen;

  if (
    !doc.fullscreenElement &&
    !doc.mozFullScreenElement &&
    !doc.webkitFullscreenElement &&
    !doc.msFullscreenElement
  ) {
    requestFullScreen.call(docEl);
  } else {
    cancelFullScreen.call(doc);
  }
}

웹 개발자는 복잡성을 싫어합니다. 사용할 수 있는 좋은 상위 수준 추상 API는 Sindre Sorhus의 Screenfull.js 모듈로, 약간 다른 두 JS API와 공급업체 프리픽스를 하나의 일관된 API로 통합합니다.

전체 화면 API 도움말

문서를 전체 화면으로 전환
본문 요소의 전체 화면
그림 1: 본문 요소의 전체 화면

body 요소를 전체 화면으로 만든다고 생각하는 것이 자연스럽지만, WebKit 또는 Blink 기반 렌더링 엔진을 사용하는 경우 body 너비를 모든 콘텐츠를 포함할 수 있는 가장 작은 크기로 축소하는 이상한 효과가 나타납니다. (Mozilla Gecko는 괜찮습니다.)

문서 요소의 전체 화면
그림 2: 문서 요소의 전체 화면

이 문제를 해결하려면 body 요소 대신 document 요소를 사용하세요.

document.documentElement.requestFullscreen();
동영상 요소를 전체 화면으로 전환

동영상 요소를 전체 화면으로 만드는 것은 다른 요소를 전체 화면으로 만드는 것과 정확히 동일합니다. 동영상 요소에서 requestFullscreen 메서드를 호출합니다.

<video id="videoElement"></video>
<button id="goFS">Go Fullscreen</button>
<script>
  var goFS = document.getElementById('goFS');
  goFS.addEventListener(
    'click',
    function () {
      var videoElement = document.getElementById('videoElement');
      videoElement.requestFullscreen();
    },
    false,
  );
</script>

<video> 요소에 컨트롤 속성이 정의되어 있지 않으면 사용자가 전체 화면으로 전환한 후 동영상을 제어할 방법이 없습니다. 이를 위한 권장 방법은 동영상과 사용자에게 표시할 컨트롤을 래핑하는 기본 컨테이너를 사용하는 것입니다.

<div id="container">
  <video></video>
  <div>
    <button>Play</button>
    <button>Stop</button>
    <button id="goFS">Go fullscreen</button>
  </div>
</div>
<script>
  var goFS = document.getElementById('goFS');
  goFS.addEventListener(
    'click',
    function () {
      var container = document.getElementById('container');
      container.requestFullscreen();
    },
    false,
  );
</script>

이렇게 하면 컨테이너 객체를 CSS 의사 선택기와 결합할 수 있으므로 훨씬 더 유연하게 사용할 수 있습니다 (예: 'goFS' 버튼 숨기기).

<style>
  #goFS:-webkit-full-screen #goFS {
    display: none;
  }
  #goFS:-moz-full-screen #goFS {
    display: none;
  }
  #goFS:-ms-fullscreen #goFS {
    display: none;
  }
  #goFS:fullscreen #goFS {
    display: none;
  }
</style>

이러한 패턴을 사용하면 전체 화면이 실행 중인 시점을 감지하고 사용자 인터페이스를 적절하게 조정할 수 있습니다. 예를 들면 다음과 같습니다.

  • 시작 페이지로 돌아가는 링크 제공
  • 대화상자를 닫거나 뒤로 이동하는 메커니즘 제공

홈 화면에서 페이지 전체 화면 실행

사용자가 전체 화면 웹페이지로 이동할 때 전체 화면 웹페이지를 실행할 수 없습니다. 브라우저 공급업체는 페이지를 로드할 때마다 전체 화면 환경이 표시되면 매우 불편하다는 점을 잘 알고 있으므로 전체 화면으로 전환하려면 사용자 동작이 필요합니다. 하지만 공급업체는 사용자가 앱을 '설치'하도록 허용하며, 설치 행위는 사용자가 플랫폼에서 앱으로 실행하기를 원한다는 신호를 운영체제에 보냅니다.

주요 모바일 플랫폼에서는 다음과 같이 메타 태그 또는 매니페스트 파일을 사용하여 쉽게 구현할 수 있습니다.

iOS

iPhone 출시 이후 사용자는 홈 화면에 웹 앱을 설치하고 전체 화면 웹 앱으로 실행할 수 있었습니다.

<meta name="apple-mobile-web-app-capable" content="yes" />

콘텐츠가 yes로 설정되면 웹 애플리케이션이 전체 화면 모드로 실행되고, 그렇지 않으면 전체 화면 모드로 실행되지 않습니다. 기본 동작은 Safari를 사용하여 웹 콘텐츠를 표시하는 것입니다. window.navigator.standalone 읽기 전용 불리언 JavaScript 속성을 사용하여 웹페이지가 전체 화면 모드로 표시되는지 확인할 수 있습니다.

Apple

Android용 Chrome

Chrome팀은 최근 사용자가 홈 화면에 페이지를 추가하면 브라우저가 페이지를 전체 화면으로 실행하도록 지시하는 기능을 구현했습니다. iOS Safari 모델과 유사합니다.

<meta name="mobile-web-app-capable" content="yes" />

애플리케이션 바로가기 아이콘이 기기의 홈 화면에 추가되도록 웹 앱을 설정하고, Android용 Chrome의 '홈 화면에 추가' 메뉴 항목을 사용하여 앱을 전체 화면 '앱 모드'로 실행할 수 있습니다.

Chrome

더 나은 옵션은 웹 앱 매니페스트를 사용하는 것입니다.

웹 앱 매니페스트 (Chrome, Opera, Firefox, 삼성)

웹 애플리케이션용 매니페스트는 개발자가 앱이 사용자에게 표시되는 방식 (예: 모바일 홈 화면)을 제어하고, 사용자가 실행할 수 있는 항목과 실행 방법을 지정할 수 있는 간단한 JSON 파일입니다. 향후에는 매니페스트를 통해 앱을 더 세밀하게 제어할 수 있게 될 예정이지만, 지금은 앱을 실행하는 방법에만 집중하겠습니다. 구체적인 내용은 다음과 같습니다.

  1. 브라우저에 매니페스트 알리기
  2. 실행 방법 설명

매니페스트를 만들고 사이트에서 호스팅한 후에는 다음과 같이 앱을 포함하는 모든 페이지에서 링크 태그를 추가하기만 하면 됩니다.

<link rel="manifest" href="/manifest.json" />

Chrome은 Android용 버전 38 (2014년 10월)부터 매니페스트를 지원해 왔으며, 이를 통해 웹 앱이 홈 화면에 설치될 때 표시되는 방식(short_name, name, icons 속성을 통해)과 사용자가 실행 아이콘을 클릭할 때 실행되는 방식(start_url, display, orientation을 통해)을 제어할 수 있습니다.

예시 매니페스트는 다음과 같습니다. 매니페스트에 포함될 수 있는 모든 항목을 표시하지는 않습니다.

{
  "short_name": "Kinlan's Amaze App",
  "name": "Kinlan's Amazing Application ++",
  "icons": [
    {
      "src": "launcher-icon-4x.png",
      "sizes": "192x192",
      "type": "image/png"
    }
  ],
  "start_url": "/index.html",
  "display": "standalone",
  "orientation": "landscape"
}

이 기능은 완전히 점진적이며 이 기능을 지원하는 브라우저 사용자를 위해 더 우수하고 통합된 환경을 만들 수 있습니다.

사용자가 사이트 또는 앱을 홈 화면에 추가하면 사용자는 이를 앱처럼 취급하려는 의도가 있습니다. 즉, 제품 방문 페이지가 아닌 앱의 기능으로 사용자를 안내하는 것을 목표로 해야 합니다. 예를 들어 사용자가 앱에 로그인해야 하는 경우 로그인 페이지를 실행하는 것이 좋습니다.

유틸리티 앱

대부분의 유틸리티 앱은 이 기능을 즉시 활용할 수 있습니다. 이러한 앱은 모바일 플랫폼의 다른 모든 앱과 마찬가지로 독립형으로 실행하는 것이 좋습니다. 앱이 독립형으로 실행되도록 하려면 웹 앱 매니페스트에 다음을 추가합니다.

    "display": "standalone"
게임

대부분의 게임은 매니페스트를 통해 즉시 이점을 얻을 수 있습니다. 대부분의 게임은 전체 화면으로 실행되고 특정 방향을 강제합니다.

세로 스크롤러나 Flappy Birds와 같은 게임을 개발하는 경우 게임이 항상 세로 모드로 표시되도록 하는 것이 좋습니다.

    "display": "fullscreen",
    "orientation": "portrait"

반면 퍼즐 게임이나 X-Com과 같은 게임을 빌드하는 경우에는 게임에서 항상 가로 모드 방향을 사용하도록 하는 것이 좋습니다.

    "display": "fullscreen",
    "orientation": "landscape"
뉴스 사이트

대부분의 경우 뉴스 사이트는 순수한 콘텐츠 기반 환경입니다. 대부분의 개발자는 뉴스 사이트에 매니페스트를 추가할 생각을 하지 않습니다. 매니페스트를 사용하면 실행할 항목 (뉴스 사이트의 첫 페이지)과 실행 방법 (전체 화면 또는 일반 브라우저 탭)을 정의할 수 있습니다.

선택은 개발자의 몫이며 사용자가 어떤 방식으로 환경에 액세스하는 것을 선호할지 고려해야 합니다. 사이트에 사이트가 가질 것으로 예상되는 모든 브라우저 크롬이 포함되도록 하려면 디스플레이를 browser로 설정하면 됩니다.

    "display": "browser"

뉴스 사이트가 대부분의 뉴스 중심 앱과 같이 앱으로 취급되고 UI에서 웹과 같은 크롬을 모두 삭제하려면 디스플레이를 standalone로 설정하면 됩니다.

    "display": "standalone"

가짜: 주소 표시줄 자동 숨기기

다음과 같이 주소 표시줄을 자동 숨기기하여 '가짜 전체 화면'을 만들 수 있습니다.

window.scrollTo(0, 1);

이 방법은 매우 간단합니다. 페이지가 로드되고 브라우저 표시줄이 사라집니다. 안타깝게도 표준화되지 않았으며 제대로 지원되지 않습니다. 또한 여러 가지 특이한 점을 해결해야 합니다.

예를 들어 브라우저는 사용자가 페이지로 다시 이동할 때 페이지의 위치를 복원하는 경우가 많습니다. window.scrollTo를 사용하면 이 설정이 재정의되어 사용자에게 불편을 줍니다. 이 문제를 해결하려면 localStorage에 마지막 위치를 저장하고 극단적인 경우 (예: 사용자가 여러 창에서 페이지를 연 경우)를 처리해야 합니다.

UX 가이드라인

전체 화면을 활용하는 사이트를 빌드할 때는 사용자가 만족할 서비스를 빌드하기 위해 알아야 할 여러 가지 잠재적인 사용자 환경 변경사항이 있습니다.

탐색 컨트롤에 의존하지 않음

iOS에는 하드웨어 뒤로 버튼이나 새로고침 동작이 없습니다. 따라서 사용자가 앱에 갇히지 않고 앱 전체를 탐색할 수 있도록 해야 합니다.

모든 주요 플랫폼에서 전체 화면 모드 또는 설치 모드로 실행 중인지 쉽게 감지할 수 있습니다.

iOS

iOS에서는 navigator.standalone 불리언을 사용하여 사용자가 홈 화면에서 실행했는지 여부를 확인할 수 있습니다.

if (navigator.standalone == true) {
  // My app is installed and therefore fullscreen
}

웹 앱 매니페스트 (Chrome, Opera, 삼성)

설치된 앱으로 실행할 때 Chrome은 실제 전체 화면 환경에서 실행되지 않으므로 document.fullscreenElement는 null을 반환하고 CSS 선택기는 작동하지 않습니다.

사용자가 사이트에서 동작을 통해 전체 화면을 요청하면 다음과 같이 전체 화면 상태에 반응하도록 UI를 조정할 수 있는 CSS 의사 선택기를 포함한 표준 전체 화면 API를 사용할 수 있습니다.

selector:-webkit-full-screen {
  display: block; // displays the element only when in fullscreen
}

selector {
  display: none; // hides the element when not in fullscreen mode
}

사용자가 홈 화면에서 사이트를 실행하면 display-mode 미디어 쿼리가 웹 앱 매니페스트에 정의된 대로 설정됩니다. 순수 전체 화면의 경우 다음과 같습니다.

@media (display-mode: fullscreen) {
}

사용자가 독립형 모드로 애플리케이션을 실행하면 display-mode 미디어 쿼리는 standalone입니다.

@media (display-mode: standalone) {
}

Firefox

사용자가 사이트를 통해 전체 화면을 요청하거나 사용자가 전체 화면 모드로 앱을 실행하면 CSS 의사 선택기를 비롯한 모든 표준 전체 화면 API를 사용할 수 있습니다. 이를 통해 다음과 같이 전체 화면 상태에 반응하도록 UI를 조정할 수 있습니다.

selector:-moz-full-screen {
  display: block; // hides the element when not in fullscreen mode
}

selector {
  display: none; // hides the element when not in fullscreen mode
}

Internet Explorer

IE에서는 CSS 의사 클래스에 하이픈이 없지만, 그 외에는 Chrome 및 Firefox와 유사하게 작동합니다.

selector:-ms-fullscreen {
  display: block;
}

selector {
  display: none; // hides the element when not in fullscreen mode
}

사양

사양의 철자는 IE에서 사용하는 문법과 일치합니다.

selector:fullscreen {
  display: block;
}

selector {
  display: none; // hides the element when not in fullscreen mode
}

사용자를 전체 화면 환경에 유지

Fullscreen API는 때때로 까다로울 수 있습니다. 브라우저 공급업체는 사용자를 전체 화면 페이지에 가두고 싶어 하지 않으므로 가능한 한 빨리 전체 화면에서 벗어날 수 있는 메커니즘을 개발했습니다. 즉, 다음과 같은 이유로 여러 페이지에 걸쳐 전체 화면 웹사이트를 빌드할 수 없습니다.

  • window.location = "http://example.com"를 사용하여 프로그래매틱 방식으로 URL을 변경하면 전체 화면이 종료됩니다.
  • 사용자가 페이지 내의 외부 링크를 클릭하면 전체 화면이 종료됩니다.
  • navigator.pushState API를 통해 URL을 변경하면 전체 화면 환경도 중단됩니다.

사용자를 전체 화면 환경에 유지하려면 다음 두 가지 옵션이 있습니다.

  1. 설치 가능한 웹 앱 메커니즘을 사용하여 전체 화면으로 전환합니다.
  2. # 프래그먼트를 사용하여 UI 및 앱 상태를 관리합니다.

# 문법을 사용하여 URL (window.location = "#somestate")을 업데이트하고 window.onhashchange 이벤트를 수신 대기하면 브라우저 자체 기록 스택을 사용하여 애플리케이션 상태의 변경사항을 관리하고, 사용자가 하드웨어 뒤로 버튼을 사용하도록 허용하거나, 다음과 같이 기록 API를 사용하여 간단한 프로그래매틱 뒤로 버튼 환경을 제공할 수 있습니다.

window.history.go(-1);

사용자가 전체 화면으로 전환할 시점을 선택하도록 허용

사용자에게 웹사이트가 예상치 못한 작업을 수행하는 것보다 더 성가신 일은 없습니다. 사용자가 사이트로 이동할 때 전체 화면으로 속이려고 하지 마세요.

첫 번째 터치 이벤트를 가로채지 않고 requestFullscreen()를 호출합니다.

  1. 짜증이 납니다.
  2. 브라우저는 향후 어느 시점에 앱이 전체 화면을 차지하도록 허용할지 사용자에게 메시지를 표시할 수 있습니다.

앱을 전체 화면으로 실행하려면 각 플랫폼의 설치 환경을 사용하는 것이 좋습니다.

홈 화면에 앱을 설치하라는 스팸을 사용자에게 보내지 마세요.

설치된 앱 메커니즘을 통해 전체 화면 환경을 제공하려는 경우 사용자를 배려하세요.

  • 신중하게 행동하세요. 배너 또는 바닥글을 사용하여 앱을 설치할 수 있음을 알립니다.
  • 사용자가 메시지를 닫으면 다시 표시하지 않습니다.
  • 사용자는 첫 방문 시 서비스에 만족하지 않는 한 앱을 설치하고 싶어 하지 않을 가능성이 높습니다. 사이트에서 긍정적인 상호작용이 발생한 후 설치를 유도해 보세요.
  • 사용자가 사이트를 정기적으로 방문하지만 앱을 설치하지 않는 경우 앞으로도 앱을 설치할 가능성이 낮습니다. 스팸을 계속 보내지 마세요.

결론

완전히 표준화되고 구현된 API는 없지만 이 도움말에 제시된 몇 가지 가이드를 사용하면 클라이언트에 관계없이 사용자의 전체 화면을 활용하는 환경을 쉽게 빌드할 수 있습니다.

의견