¶ MLocale
MLocale Framework 에 대한 필수 API 를 정의
¶ Locale API
다국어와 관련된 기능들을 제공
참고사항
- Manifest.xml 의 언어코드가 설정된 경우 : 언어코드로 셋팅
- Manifest.xml 의 언어코드가 system인 경우 : 사용자 단말기 OS에서 사용중인 기본 언어코드를 사용
- 사용자가 선택한 언어를 사용하고자 하는 경우 : 해당 언어코드를 저장 후, 언어를 set 하도록 처리
¶ 다국어 파일 생성
-
언어팩 생성 (다국어키/lang.js)
기본언어 : default/lang.js
- 다국어키가 설정되지 않은 경우 기본언어에 설정된 내용이 출력됩니다.
다국어 설정예
- 한국어 : ko-kr/lang.js
- 영어 : en-us/lang.js
- 일본어 : ja-jp/lang.js
- 중국어 : zh-cn/lang.js
-
생성위치 / 형식
-
언어팩 상세
Example:영어 설정 상세 M.locale.loadData("en-us", { "hello": "Hello !!", "hello_user": "Hello, %s!!" });한국어 설정 상세 M.locale.loadData("ko-kr", { "hello": "안녕하세요", "hello_user": "%s님 안녕하세요" });기본언어 파일 상세 (언어가 지원되지 않은 경우, 사용하는 파일로, 공용어를 권장합니다.) M.locale.loadData( "default", { "hello": "Hello !!", "hello_user": "Hello, %s!!" });
¶ 다국어 Rules 설정
¶ M.locale.loadData( locale, data )
Arguments
- String(String) - 다국어 키
- Object(Object) - 다국어 데이타
- 언어 Rules 설정
Example:
M.locale.loadData( "default", {
"hello": "Hello !!",
"hello_user": "Hello, %s!!"
});
¶ 언어 변경 이벤트
¶ M.locale.onChange( handler )
Arguments
- handler(Function) - Event Handler
¶ M.locale.handler( event )
Arguments
- event(event) - 이벤트 객체
- 언어 변경 이벤트시, 처리함
Example:
M.locale.onChange( function() {
// 이미 적용된 다국어 내용 수정
});
¶ 다국어 변환 출력
¶ M.locale.localizedString( key )
Arguments
- key(String) - 언어
Example:
var text = M.locale.localizedString("hello"); // Hello
¶ M.locale.localizedString( format, args... )
Arguments
- key(String) - 언어
Example:
var text = M.locale.localizedString("hello_user", "John"); // Hello, John