콘텐츠로 이동

레지스터

읽기 전...

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

레지스터는 한 값이 변경될 때, 그 값을 사용한 곳이 업데이트 될 수 있도록 만들어주는 Quad 의 주요 기술입니다. 추후 설명될 Class.Extend 와도 사용이 가능합니다.

레지스터는 이러한 시나리오에서 사용될 수 있습니다.
1. UI 의 여러 오브젝트를 한번에 페이드 아웃 혹은 페이드 인 시키는 경우.
2. 가변 크기의 UI 를 업데이트 시키는 경우.
3. 여러 오브젝트들을 한꺼번에 트윈시키는 경우.
4. 다크테마/화이트테마 변경할 수 있게 만드는 경우.

이외에도 레지스터의 활용 방법은 무궁무진합니다. 레지스터의 사용법은 다음과 같습니다. 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
local ScreenGUI = script.Parent
local Quad = require(path.to.module).Init()
local Store = Quad.Store
local Class = Quad.Class
local Mount = Quad.Mount

-- 레지스터를 만들 수 있는 테이블을 만듭니다.
-- 여기에 담아내는 값을 업데이트 하는 경우 레지스터로 연결된
-- 오브젝트들도 같이 업데이트됩니다.
local myStore = Store.GetStore("myStore")
local TextLabel = Class "TextLabel"

myStore.Text = "0 초 지남"

TextLabel "mainLabel" {
    Size = UDim2.fromOffset(100,200);
    -- myStore 의 Text 값이 변경됨을 추적하고, Text 값을
    -- 업데이트 시킵니다.
    Text = myStore "Text";
}

Mount(ScreenGUI, Store.GetObject("mainLabel"))

local Count = 0
while true do
    task.wait(1)
    -- 값을 업데이트 합니다. 텍스트 라벨도
    -- 자동적으로 업데이트 됩니다.
    myStore.Text = Count .. " 초 지남"
    Count = Count + 1
end

레지스터에는 여러가지 메소드가 담겨있습니다. 이 메소드를 사용하면 레지스터를 보다 더 다양하게 활용할 수 있습니다.

register 특수 메소드가 적용되는 순서는 다음과 같습니다.

:Add(value:any)->register

값에 더하기를 취합니다. 음수형태가 제공되는 경우 빼기 처럼 작동합니다.
number, Udim, UDim2, Color3, Vector2 등 더할 수 있는 모든것을 사용할 수 있습니다
주의 : 구조의 복잡성을 피하고자, 여러번 호출시 가장 마지막 호출된 것만 사용됩니다

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
-- 용법
local ScreenGUI = script.Parent
local Quad = require(path.to.module).Init()
local Store = Quad.Store
local Class = Quad.Class
local Mount = Quad.Mount

local Frame = Class "Frame"
local myStore = Store.GetStore("myStore")

myStore.pos = UDim2.fromOffset(100,0)

Frame "mainFrame" {
    Position = myStore "pos":Add(UDim2.fromOffset(0,100));
}
Mount(ScreenGUI, Store.GetObject("mainFrame"))

while true do
    myStore.pos = myStore.pos + UDim2.fromOffset(10,0)
    task.wait(2)
end

:With((store:valueStore, newValue:any, key:string)->())->register

함수 또는 테이블에서 값을 가져옵니다. Add 보다 나중에 수행됩니다.
첫번째 값에는 편의상 스토어 값이 제공되며, 새로운 값과, 바뀐 값에 대한 키가 제공됩니다
주의 : 구조의 복잡성을 피하고자, 여러번 호출시 가장 마지막 호출된 것만 사용됩니다

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
-- 용법
local ScreenGUI = script.Parent
local Quad = require(path.to.module).Init()
local Store = Quad.Store
local Class = Quad.Class
local Mount = Quad.Mount

local Frame = Class "Frame"
local myStore = Store.GetStore("myStore")

myStore.topbarSize = 60
myStore.width = 200

-- 레지스터를 변수로 두고 사용합니다
local listItemSize = myStore "width":With(function()
    return UDim2.fromOffset(myStore.width,60)
end)

Frame "mainFrame" {
    Class "UIListLayout" { SortOrder = Enum.SortOrder.LayoutOrder };

    -- 사이즈가 width 에 맞게 업데이트됩니다
    Size = myStore "width":With(function ()
        return UDim.fromOffset(store.width,400)
    end);

    Frame "Topbar" {
        LayoutOrder = 1;
        BackgroundColor3 = Color3.fromRGB(255,0,0);
        -- 이렇게 여러 값을 묶어서 두 값이 변경됨, 혹은 그이상을
        -- 만들 수 있습니다.
        Size = myStore "topbarSize,width":With(function()
            return UDim2.fromOffset(myStore.width,myStore.topbarSize)
        end);
    }
    Frame "ListItem" {
        LayoutOrder = 2;
        BackgroundColor3 = Color3.fromRGB(0,255,0);
        Size = listItemSize;
    };
    Frame "ListItem" {
        LayoutOrder = 3;
        BackgroundColor3 = Color3.fromRGB(0,0,255);
        Size = listItemSize;
    };
}

Mount(ScreenGUI, Store.GetObject("mainFrame"))

-- width 값을 변경해보세요
while true do
    myStore.width = myStore.width + 10
    task.wait(1)
end

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
-- 용법
local ScreenGUI = script.Parent
local Quad = require(path.to.module).Init()
local Store = Quad.Store
local Class = Quad.Class
local Mount = Quad.Mount

local Frame = Class "Frame"
local myStore = Store.GetStore("myStore")

local colors = {
    Color3.fromRGB(255,255,255);
    Color3.fromRGB(255,255,0);
    Color3.fromRGB(0,255,255);
    Color3.fromRGB(255,0,255);
    Color3.fromRGB(255,0,0);
    Color3.fromRGB(0,255,0);
    Color3.fromRGB(0,0,255);
}
myStore.color = 1

Frame "mainFrame" {
    BackgroundColor3 = myStore "color":With(colors);
}
Mount(ScreenGUI, Store.GetObject("mainFrame"))

while task.wait(1) do
    myStore.color = (i-1)%(#colors)+2
end

:Tween(options:TweenOptions)

트윈을 이용해 변경사항을 적용합니다(처음 오브젝트 생성시에는 적용되지 않음) 옵션은 Tween 문서에 나와있는 옵션과 같습니다. 주의 : 구조의 복잡성을 피하고자, 여러번 호출시 가장 마지막 호출된 것만 사용됩니다

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
-- 용법
local ScreenGUI = script.Parent
local Quad = require(path.to.module).Init()
local Store = Quad.Store
local Class = Quad.Class
local Mount = Quad.Mount
local Style = Quad.Style

local Frame = Class "Frame"
local myStore = Store.GetStore("myStore")
myStore.pos = UDim2.fromOffset(50,0)
Style "TweenFrame" {
    Size = UDim2.fromOffset(50,50);
    BackgroundColor3 = Color3.fromRGB(255,100,255);
}

Frame "mainFrame" {
    BackgroundColor3 = Color3.fromRGB(255,255,255);
    Size = UDim2.fromOffset(500,500);
    Frame "TweenFrame" {
        Position = myStore "pos":Tween{Time = 2};
    };
    Frame "TweenFrame" {
        Position = myStore "pos"
            :Add(UDim2.fromOffset(0,100))
            :Tween{Time = 2};
    };
    Frame "TweenFrame" {
        Position = myStore "pos"
            :Add(UDim2.fromOffset(0,200))
            :Tween{Time = 2};
    };
    Frame "TweenFrame" {
        Position = myStore "pos"
            :Add(UDim2.fromOffset(0,300))
            :Tween{Time = 2};
    }
}

Mount(ScreenGUI, Store.GetObject("mainFrame"))

local on = false
while true do
    on = not on
    myStore.pos = on and UDim2.fromOffset(400,0) or UDim2.fromOffset(50,0)
end

:Default(value:any)

기본값을 정합니다. 만약 값이 nil 인 경우 이 값을 사용하게 됩니다. Add 나 With 등 다른것에 영향받지 않습니다.
주의 : 처음 오브젝트가 생성될 때에만 이 값이 사용됩니다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
-- 용법
local ScreenGUI = script.Parent
local Quad = require(path.to.module).Init()
local Store = Quad.Store
local Class = Quad.Class
local Mount = Quad.Mount

local Frame = Class "Frame"
local myStore = Store.GetStore("myStore")

Frame "mainFrame" {
    Size = UDim2.fromOffset(200,200);
    -- color 값이 없으므로 Default 안의 값이 사용됩니다.
    BackgroundColor3 = myStore "color"
        :Default(Color3.fromRGB(255,0,0));
}

Mount(ScreenGUI, Store.GetObject("mainFrame"))

task.wait(5)
myStore.color = Color3.fromRGB(0,255,0)

:Register((store:valueStore, newValue:any, key:string)->())->nil

레지스터에 함수를 등록합니다. 값이 변경되면 함수가 실행됩니다. 첫번째 값에는 편의상 스토어 값이 제공되며, 새로운 값과, 바뀐 값에 대한 키가 제공됩니다

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
-- 용법
local Quad = require(path.to.module).Init()
local Store = Quad.Store

local myStore = Store.GetStore("myStore")

myStore.test1 = 1
myStore.test2 = "Hello"

myStore "test1,test2":Register(function()
    print(myStore.test1,myStore.test2)
end)

myStore.test1 = 2