==========
MLocale
==========

MLocale Framework 에 대한 필수 API 를 정의


------------
Locale API
------------

다국어와 관련된 기능들을 제공




다국어 파일 생성
--------------

1. 언어팩 생성 (다국어키/lang.js)
   	
	기본언어 : default/lang.js
	
		- 다국어키가 설정되지 않은 경우 기본언어에 설정된 내용이 출력됩니다.

	다국어 설정예

		- 한국어 : ko-kr/lang.js
		- 영어 : en-us/lang.js
		- 일본어 : ja-jp/lang.js
		- 중국어 : zh-cn/lang.js

2. 생성위치 / 형식

.. figure:: ../_static/api/locales_01.png

3. 언어팩 상세
	Example:
	
	.. code-block:: javascript
	
		영어 설정 상세
		
		M.locale.loadData("en-us", {
		    "hello": "Hello !!",
		    "hello_user": "Hello, %s!!"
		});
	
	
	.. code-block:: javascript
	
		한국어 설정 상세
		
		M.locale.loadData("ko-kr", {
		    "hello": "안녕하세요",
		    "hello_user": "%s님 안녕하세요"
		});
	
	
	.. code-block:: javascript
	
		기본언어  파일 상세 (언어가 지원되지 않은 경우, 사용하는 파일로, 공용어를 권장합니다.)
		
		M.locale.loadData( "default", {
		    "hello": "Hello !!",
		    "hello_user": "Hello, %s!!"
		});

다국어 Rules 설정
---------------

.. js:function:: M.locale.loadData( locale, data )

	:param String: 다국어 키
	:param Object: 다국어 데이타
	
	* 언어 Rules 설정

	Example:
	
	.. code-block:: javascript
	
		M.locale.loadData( "default", {
		    "hello": "Hello !!",
		    "hello_user": "Hello, %s!!"
		});



언어 변경 이벤트
--------------

.. js:function:: M.locale.onChange( handler )

	:param Function handler: Event Handler
	
	.. js:function:: handler( event )
	
		:param event: 이벤트 객체
		

	* 언어 변경 이벤트시, 처리함

	Example:
	
	.. code-block:: javascript
	
		M.locale.onChange( function() {
			// 이미 적용된 다국어 내용 수정
		});


다국어 변환 출력
--------------

.. js:function:: M.locale.localizedString( key )

	:param String key: 언어
	
	Example:
		
	.. code-block:: javascript
	
		var text = M.locale.localizedString("hello"); // Hello
		

.. js:function:: M.locale.localizedString( format, args...  )

	:param String key: 언어
	
	Example:
		
	.. code-block:: javascript
	
		var text = M.locale.localizedString("hello_user", "John"); // Hello, John


다국어 설정값 가져오기
--------------

.. js:function:: M.locale.get()

	 :return: String
	 
	Example:
		
	.. code-block:: javascript
	
		var locale = M.locale.get();


다국어 언어 설정
--------------

.. js:function:: M.locale.set(value)

	 :param String key: 언어-국가
	 
	Example:
		
	.. code-block:: javascript
	
		M.locale.set("ja-jp");