JavaScript를 사용하여 페이지의 가시성 변경 시 제목 업데이트

웹 페이지가 사용자에게 보이는지 여부를 감지하고 그에 따라 브라우저 탭의 제목을 동적으로 변경하는 것은 사용자 경험을 향상시키는 데 유용할 수 있습니다. 이 기능은 사용자의 주의를 끌거나, 백그라운드 작업 상태를 알리거나, 단순히 인터랙티브한 피드백을 제공하는 데 사용될 수 있습니다.

JavaScript에서는 이러한 가시성 변경을 감지하고 제목을 업데이트하는 몇 가지 방법을 사용할 수 있습니다.

1. focus 및 blur 이벤트 사용

가장 기본적인 방법 중 하나는 창이나 탭에 포커스가 맞춰지거나 벗어날 때 발생하는 focus 및 blur 이벤트를 활용하는 것입니다. 이 이벤트들은 페이지가 활성화되거나 비활성화될 때 트리거됩니다. document.title 속성을 직접 수정하여 탭의 제목을 변경할 수 있습니다.


window.onfocus = function() {
  console.log("페이지 포커스 획득");
  document.title = "현재 활성";
};

window.onblur = function() {
  console.log("페이지 포커스 잃음");
  document.title = "비활성 상태";
};

이 방법은 사용자가 다른 탭이나 애플리케이션으로 전환할 때 페이지가 비활성화되었음을 나타내는 데 효과적입니다.

2. Page Visibility API 사용

HTML5는 페이지의 가시성 상태를 더 세밀하게 제어할 수 있는 Page Visibility API를 도입했습니다. 이 API는 visibilitychange 이벤트를 사용하여 페이지가 숨겨지거나 표시될 때를 감지합니다.

2.1. document.hidden 속성 활용

document.hidden 속성은 페이지가 사용자에게 숨겨진 상태이면 true를, 그렇지 않으면 false를 반환합니다. visibilitychange 이벤트 리스너 내에서 이 속성을 확인하여 페이지의 현재 상태를 파악하고 제목을 업데이트할 수 있습니다.


function updateTitleOnVisibilityChange() {
  if (document.hidden) {
    document.title = "숨겨짐";
  } else {
    document.title = "표시 중";
  }
}

document.addEventListener("visibilitychange", updateTitleOnVisibilityChange);

addEventListener 메서드는 세 번째 인수로 useCapture 옵션을 받을 수 있으며, 기본값은 false입니다. 여기서는 기본값을 사용합니다.

2.2. document.visibilityState 속성 활용

document.visibilityState 속성은 페이지의 가시성 상태를 문자열 값으로 제공합니다. 가능한 값은 다음과 같습니다:

  • visible: 페이지 내용이 사용자에게 최소한 부분적으로 보입니다. 일반적으로 브라우저 창의 활성 탭에 해당합니다.
  • hidden: 페이지 내용이 사용자에게 보이지 않습니다. 백그라운드 탭, 최소화된 창 또는 잠긴 운영 체제 화면 상태일 수 있습니다.
  • prerender: 페이지 내용이 미리 렌더링 중이며 사용자에게 보이지 않습니다. 이 상태는 document.hidden에 의해 숨겨진 것으로 간주됩니다.

이 상태 값을 사용하여 제목을 더욱 구체적으로 업데이트할 수 있습니다.


function updateTitleBasedOnState() {
  switch (document.visibilityState) {
    case "hidden":
      document.title = "백그라운드";
      break;
    case "visible":
      document.title = "포그라운드";
      break;
    case "prerender":
      document.title = "미리 렌더링 중";
      break;
  }
}

document.addEventListener("visibilitychange", updateTitleBasedOnState);

3. 호환성을 고려한 고급 예제 (MDN 참조)

다양한 브라우저에서 Page Visibility API를 일관되게 사용하기 위해 MDN 웹 문서에서는 다음과 같은 호환성 코드를 제공합니다. 이 예제는 사용자가 페이지를 벗어날 때 비디오를 일시 중지하고, 페이지 가시성 상태에 따라 document.title을 변경합니다.


let hiddenProperty, visibilityChangeEvent;

if (typeof document.hidden !== "undefined") {
  hiddenProperty = "hidden";
  visibilityChangeEvent = "visibilitychange";
} else if (typeof document.msHidden !== "undefined") {
  hiddenProperty = "msHidden";
  visibilityChangeEvent = "msvisibilitychange";
} else if (typeof document.webkitHidden !== "undefined") {
  hiddenProperty = "webkitHidden";
  visibilityChangeEvent = "webkitvisibilitychange";
}

const videoElement = document.getElementById("myVideo"); // 가정: 비디오 요소 ID가 'myVideo'

function handleVisibilityChangeAdvanced() {
  if (document[hiddenProperty]) {
    videoElement.pause();
    console.log("비디오 일시 중지됨 (페이지 숨김)");
  } else {
    videoElement.play();
    console.log("비디오 재생 시작 (페이지 표시)");
  }
}

if (typeof document.addEventListener === "undefined" || typeof document[hiddenProperty] === "undefined") {
  console.warn("이 데모는 Page Visibility API를 지원하는 브라우저가 필요합니다.");
} else {
  document.addEventListener(visibilityChangeEvent, handleVisibilityChangeAdvanced, false);

  videoElement.addEventListener("pause", () => {
    document.title = '비디오 일시 중지됨';
  }, false);

  videoElement.addEventListener("play", () => {
    document.title = '비디오 재생 중';
  }, false);
}

이 코드는 브라우저별 접두사를 처리하고, 페이지 가시성 변경 시 비디오 재생/일시 중지 기능을 제어하며, 비디오의 재생 상태 변경에 따라 탭 제목을 업데이트합니다.

태그: JavaScript Page Visibility API DOM 이벤트 핸들링 프론트엔드

10월 16일 11:01에 게시됨