국제화

DEXTUploadX5 제품은 대한민국 인터넷 환경에서 사용되도록 모든 문자열 리소스를 한국어로 작성했다.

DEXTUploadX5 제품이 기본적으로 제공하는 리소스 파일은 다음과 같으며 res 디렉터리 안에 있다.

• 기본 리소스 파일:

  • dextuploadx5-svg-message-ko.txt
  • dextuploadx5-svg-message-en.txt
  • dextuploadx5-svg-message-ja.txt
  • dextuploadx5-svg-message-zh.txt

• HD 응용프로그램 리소스 파일: (2.0.0.0 버전부터)

  • dextuploadx5-hd-message-ko.xml
  • dextuploadx5-hd-message-en.xml
  • dextuploadx5-hd-message-ja.xml
  • dextuploadx5-hd-message-zh.xml

영어, 일본어, 중국어는 1.3.0.0 버전에서 추가되었다.

글로벌 서비스를 지향하는 경우라면, 한국어를 지원하지 않는 브라우저를 사용할 수 있다. 그러므로 다국어 환경을 유념하여 서비스를 한다면, 지원하려는 언어 리소스를 직접 만들어서 등록해주어야 한다.

(기본으로 제공하는 한국어, 영어, 일본어, 중국어를 제외한 타 언어 리소스는 직접 제작해야 한다.)

# DEXTUploadX5 리소스 위치에는 기본적으로 한국어, 영어, 일본어, 중국어 메시지 리소스가 포함되어 있다.
dextuploadx5-svg-message-ko.txt
dextuploadx5-svg-message-en.txt
dextuploadx5-svg-message-ja.txt
dextuploadx5-svg-message-zh.txt
# 만일 다른 언어 리소스를 사용하려면 알맞은 언어 리소스를 생성하여 같은 위치에 넣는다.
dextuploadx5-svg-message-fr.txt

# HD 응용프로그램
# DEXTUploadX5 리소스 위치에는 기본적으로 한국어, 영어, 일본어, 중국어 메시지 리소스가 포함되어 있다.
dextuploadx5-hd-message-ko.xml
dextuploadx5-hd-message-en.xml
dextuploadx5-hd-message-ja.xml
dextuploadx5-hd-message-zh.xml
# 만일 다른 언어 리소스를 사용하려면 알맞은 언어 리소스를 생성하여 같은 위치에 넣는다.
dextuploadx5-hd-message-fr.xml

제품은 내부적으로 navigator.language, navigator.browserLanguage, navigator.systemLanguage 순으로 지원되는 언어를 찾는다. 만약 리소스 suffix(ko, en, ja, zh, ...)와 일치하지 않는 경우, 특정 리소스(일반적으로 영문으로)로 고정해야 할 필요가 있다. dx5.create 함수를 사용하여 컴포넌트를 생성할 때, 사용할 언어 리소스를 강제로 지정할 수 있다. 강제로 언어가 지정되면, 브라우저 언어와 상관없이 해당 언어 리소스를 찾는다.

// 자동으로 언어를 선택한다.
dx5.create({ id: "dext5-1", parentId: "dext5-container1" });
// 한국어로 설정한다.
dx5.create({ id: "dext5-2", parentId: "dext5-container2", lang: "ko" });
// 영어로 설정한다.
dx5.create({ id: "dext5-3", parentId: "dext5-container3", lang: "en" });
// 일본어로 설정한다.
dx5.create({ id: "dext5-4", parentId: "dext5-container4", lang: "ja" });
// 중국어로 설정한다.
dx5.create({ id: "dext5-5", parentId: "dext5-container5", lang: "zh" });

// HD 응용프로그램인 경우는 컴포넌트의 기본 리소스 설정을 따른다.

브라우저의 언어 또는 지정된 언어(lang 속성 사용)를 지원하는 리소스 파일을 찾을 수 없다면, 내장된 영문 리소스를 사용한다. 내장된 영문 리소스는 3.10.0.0 버전부터 지원하며, 이전 버전에서는 리소스가 없는 경우 오류가 발생한다.