Lang - 언어관리

읽기 전...

모듈 설정시 .Init() 처럼 QuadId 란을 비워두는 경우 Lang 기능이 코드를 넘어 공유되지 않습니다
하지만 .Init("Project1") 처럼 아이디를 부여하는 경우 다른 모듈, 로컬스크립트가 접근하더라도 같은 QuadId 를 가졌다면 Lang 은 공유됩니다

---

언어관리

Quad 에는 귀찮은 언어관리를 자동으로 해주는 기능이 내장되어 있습니다. 이 기능은 register 와 연동해 적은 줄의 코드로 변하는 텍스트도 언어에 맞게 출력되도록 만들 수 있습니다.

번역 테이블은 Lang.New(LangName:string,{ [Locale]: string|(options)->string }) 다음을 이용해 만들 수 있으며.
Lang(LangName:string)(options)->register 로 UI 에 적용시킬 수 있습니다.

Lang.Locales.Default 는 일치하는 언어가 없을때 보여줄 언어입니다. 일반적으로 영어를 추천합니다.

용법예제 - 다중언어 카운터

Lang.New("Test",{
    [Lang.Locales.Korean] = "{won} 원";
    [Lang.Locales.Default] = "{won} Won";
})
TextLabel {
    Lang "Test" {
        won = 100;
    };
}

local ScreenGUI = script.Parent
local Quad = require(path.to.module).Init()
local Store = Quad.Store
local Mount = Quad.Mount
local Event = Quad.Event
local Lang = Quad.Lang
local Class = Quad.Class

local TextButton = Class "TextButton"

local myStore = Store.GetStore("myStore")
myStore.count = 0

Lang.New("TimePassed",{
    [Lang.Locales.Korean] = "{count}초 지났어요";
    [Lang.Locales.Default] = function (options)
        -- 함수 또한 등록할 수 있습니다.
        if options.count > 1 then
            return ("%d seconds passed"):format(options.count)
        else
            return ("%d second passed"):format(options.count)
        end
    end;
})

TextButton "mainButton" {
    Size = UDim2.fromOffset(100,100);
    Text = Lang "TimePassed" {
        -- count = 1 일반적인 값도 사용가능합니다
        count = myStore "count";
    };
    [Event "MouseButton1Click"] = function()
        -- 클릭시 언어가 변경됩니다
        if Lang.CurrentLocale == Lang.Locales.Default then
            Lang.CurrentLocale = Lang.Locales.Korean
        else
            Lang.CurrentLocale = Lang.Locales.Default
        end
    end
}
Mount(ScreenGUIk,Store.GetObject("mainButton"))

while task.wait(1) do
    myStore.count = myStore.count + 1
end

주의

구현의 복잡성의 이유로 Lang 은 레지스터와 같은 제약을 가집니다 (오브젝트 생성시에만 등록할 수 있습니다)

local myLabel = TextLabel{}
Lang.new("Test",{ [Lang.Locales.Default] = "{lang}" })
myLabel.Text = Lang "Test" { lang = 1 }

위처럼 사용할 수 없습니다.

대신에 :Register 문법을 사용하여 등록할 수 있습니다.

local myLabel = TextLabel{}
Lang.new("Test",{ [Lang.Locales.Default] = "{lang}" })
Apply (myLabel) {
    Text = Lang "Test" { lang = 1 };
}

---

Locale 목록

로케일 값들은 Lang.Locales에서 가져올 수 있으며, 사용가능한 로케일 목록은 다음과 같습니다.

Default (default)
English (en-us)
Spanish (es-es)
French (fr-fr)
Indonesian (id-id)
Italian (it-it)
Japanese (ja-jp)
Korean (ko-kr)
Russian (ru-ru)
Thai (th-th)
Turkish (tr-tr)
Vietnamese (vi-vn)
Portuguese (pt-br)
German (de-de)
ChineseSimplified (zh-cn)
ChineseTraditional (zh-tw)
Bulgarian (bg-bg)
Bengali (bn-bd)
Czech (cs-cz)
Danish (da-dk)
Greek (el-gr)
Estonian (et-ee)
Finnish (fi-fi)
Hindi (hi-in)
Croatian (hr-hr)
Hungarian (hu-hu)
Georgian (ka-ge)
Kazakh (kk-kz)
Khmer (km-kh)
Lithuanian (lt-lt)
Latvian (lv-lv)
Malay (ms-my)
Burmese (my-mm)
Bokmal (nb-no)
Dutch (nl-nl)
Filipino (fil-ph)
Polish (pl-pl)
Romanian (ro-ro)
Ukrainian (uk-ua)
Sinhala (si-lk)
Slovak (sk-sk)
Slovenian (sl-sl)
Albanian (sq-al)
Bosnian (bs-ba)
Serbian (sr-rs)
Swedish (sv-se)
Arabic (ar-001)