자바스크립트 Universal Viewer는 웹 페이지에서 이미지, 비디오, 오디오 등 다양한 형식의 미디어 콘텐츠를 보여주는 뷰어 라이브러리입니다. 이 라이브러리는 다국어 지원 기능을 제공하여 웹 페이지를 다국어로 제공하는 경우 편리하게 사용할 수 있습니다.

다국어 지원을 위한 라이브러리 설치

Universal Viewer의 다국어 지원 기능을 사용하기 위해서는 다음과 같이 라이브러리를 설치해야 합니다.

npm install universalviewer-multilanguage

다국어 리소스 파일 작성

Universal Viewer는 다국어 리소스 파일을 사용하여 각 언어에 해당하는 텍스트를 제공합니다. 다국어 리소스 파일은 JSON 형식으로 작성되며, 각 언어별로 키-값 형태로 구성됩니다. 예를 들어, 한국어와 영어로 뷰어의 버튼 텍스트를 제공하려면 다음과 같이 리소스 파일을 작성할 수 있습니다.

// resources_ko.json
{
  "button_next": "다음",
  "button_previous": "이전",
  "button_zoom_in": "확대",
  "button_zoom_out": "축소"
}

// resources_en.json
{
  "button_next": "Next",
  "button_previous": "Previous",
  "button_zoom_in": "Zoom In",
  "button_zoom_out": "Zoom Out"
}

다국어 리소스 파일 로드

라이브러리를 로드하고 다국어 리소스 파일을 로드하기 위해 다음과 같은 코드를 사용합니다.

import Viewer from 'universalviewer-multilanguage';

// 뷰어 인스턴스 생성
const viewer = new Viewer();

// 다국어 리소스 파일 로드
const language = 'ko'; // 사용자의 언어 설정에 따라 동적으로 변경 가능하도록 구현
fetch(`resources_${language}.json`)
  .then(response => response.json())
  .then(resources => {
    // 리소스 파일을 뷰어에 적용
    viewer.setResources(resources);
  });

다국어 지원 적용

다국어 리소스 파일을 로드하고 적용한 뷰어는 해당 언어에 맞는 텍스트를 사용하여 인터페이스를 표시합니다. 예를 들어, 다음 코드는 이전 버튼의 텍스트를 표시하는 예시입니다.

const previousButton = viewer.getButton('button_previous');
console.log(previousButton.getText());

위의 코드는 해당 언어에 맞는 텍스트를 출력합니다. 한국어를 기준으로 작성한 리소스 파일을 로드한 경우 “이전”이라는 텍스트가 출력됩니다.

결론

자바스크립트 Universal Viewer의 다국어 지원 기능을 통해 웹 페이지에서 다양한 언어로 제공되는 미디어 콘텐츠를 사용자에게 편리하게 보여줄 수 있습니다. 리소스 파일을 작성하고 로드하여 다국어 텍스트를 인터페이스에 적용하는 방법을 알아보았습니다.