Line data Source code
1 : package hooks
2 :
3 : import "github.com/kijimaD/ruins/internal/inputmapper"
4 :
5 : // TabMenuConfig はタブメニューの設定
6 : type TabMenuConfig struct {
7 : TabCount int // タブの数
8 : ItemCounts []int // 各タブのアイテム数
9 : ItemsPerPage int // 1ページに表示するアイテム数(0=ペジネーションなし)
10 : Skips [][]bool // 各タブのスキップ判定。trueの位置はカーソルが止まらない
11 : }
12 :
13 : // TabMenuState はタブメニューの状態
14 : type TabMenuState struct {
15 : TabIndex int
16 : ItemIndex int
17 : Page int // 現在のページ(0ベース)
18 : }
19 :
20 : // tabMenuNav はタブメニューのナビゲーションロジックを保持する
21 : type tabMenuNav struct {
22 : config TabMenuConfig
23 : }
24 :
25 : func (n *tabMenuNav) itemCountForTab(tabIdx int) int {
26 1 : if tabIdx >= 0 && tabIdx < len(n.config.ItemCounts) {
27 1 : return n.config.ItemCounts[tabIdx]
28 1 : }
29 1 : return 0
30 : }
31 :
32 : func (n *tabMenuNav) isSkip(tabIdx, itemIdx int) bool {
33 1 : if tabIdx < 0 || tabIdx >= len(n.config.Skips) {
34 1 : return false
35 1 : }
36 1 : skips := n.config.Skips[tabIdx]
37 1 : if itemIdx < 0 || itemIdx >= len(skips) {
38 1 : return false
39 1 : }
40 1 : return skips[itemIdx]
41 : }
42 :
43 : // skipNext は指定タブ内で指定方向にスキップ対象でない次のインデックスを返す
44 : func (n *tabMenuNav) skipNext(tabIdx, idx, dir int) int {
45 1 : count := n.itemCountForTab(tabIdx)
46 1 : if tabIdx < 0 || tabIdx >= len(n.config.Skips) || len(n.config.Skips[tabIdx]) == 0 {
47 1 : return idx
48 1 : }
49 1 : for range count {
50 1 : if !n.isSkip(tabIdx, idx) {
51 1 : return idx
52 1 : }
53 1 : idx = (idx + dir + count) % count
54 : }
55 1 : return idx
56 : }
57 :
58 : func (n *tabMenuNav) firstSelectable(tabIdx int) int {
59 1 : return n.skipNext(tabIdx, 0, 1)
60 1 : }
61 :
62 : // clamp はアイテム数変化に対してインデックスを安全な範囲に収める
63 : func (n *tabMenuNav) clamp(s TabMenuState) TabMenuState {
64 1 : count := n.itemCountForTab(s.TabIndex)
65 1 : if count == 0 {
66 1 : s.ItemIndex = 0
67 2 : } else if s.ItemIndex >= count {
68 1 : s.ItemIndex = count - 1
69 1 : }
70 1 : return s
71 : }
72 :
73 : // navHandlers は移動系 Action と状態遷移の対応表。移動系の集合の唯一の定義で、
74 : // DispatchNav の消費判定も reduce の分岐もここから導く。集合と挙動が別の場所に複製されると
75 : // 片方だけ更新してずれるため、1つの表に束ねる
76 : var navHandlers = map[inputmapper.ActionID]func(*tabMenuNav, TabMenuState) TabMenuState{
77 : inputmapper.ActionMenuTabPrev: (*tabMenuNav).tabPrev,
78 : inputmapper.ActionMenuTabNext: (*tabMenuNav).tabNext,
79 : inputmapper.ActionMenuUp: (*tabMenuNav).up,
80 : inputmapper.ActionMenuDown: (*tabMenuNav).down,
81 : inputmapper.ActionMenuLeft: (*tabMenuNav).left,
82 : inputmapper.ActionMenuRight: (*tabMenuNav).right,
83 : }
84 :
85 : // reduce はアクションに応じて状態を更新する。移動系でなければ何もしない
86 : func (n *tabMenuNav) reduce(s TabMenuState, a inputmapper.ActionID) TabMenuState {
87 1 : s = n.clamp(s)
88 1 : if h, ok := navHandlers[a]; ok {
89 1 : return h(n, s)
90 1 : }
91 1 : return s
92 : }
93 :
94 : // tabPrev は前のタブへ循環して移り、カーソルを新タブの先頭選択可能行へ置く
95 : func (n *tabMenuNav) tabPrev(s TabMenuState) TabMenuState {
96 1 : if n.config.TabCount == 0 {
97 1 : return s
98 1 : }
99 1 : newTab := (s.TabIndex - 1 + n.config.TabCount) % n.config.TabCount
100 1 : return TabMenuState{TabIndex: newTab, ItemIndex: n.firstSelectable(newTab)}
101 : }
102 :
103 : // tabNext は次のタブへ循環して移り、カーソルを新タブの先頭選択可能行へ置く
104 : func (n *tabMenuNav) tabNext(s TabMenuState) TabMenuState {
105 1 : if n.config.TabCount == 0 {
106 1 : return s
107 1 : }
108 1 : newTab := (s.TabIndex + 1) % n.config.TabCount
109 1 : return TabMenuState{TabIndex: newTab, ItemIndex: n.firstSelectable(newTab)}
110 : }
111 :
112 : // up はカーソルを1つ上へ動かす。端では循環し、見出し行は飛ばす
113 : func (n *tabMenuNav) up(s TabMenuState) TabMenuState {
114 1 : count := n.itemCountForTab(s.TabIndex)
115 1 : if count == 0 {
116 1 : return s
117 1 : }
118 1 : next := (s.ItemIndex - 1 + count) % count
119 1 : return TabMenuState{TabIndex: s.TabIndex, ItemIndex: n.skipNext(s.TabIndex, next, -1)}
120 : }
121 :
122 : // down はカーソルを1つ下へ動かす。端では循環し、見出し行は飛ばす
123 : func (n *tabMenuNav) down(s TabMenuState) TabMenuState {
124 1 : count := n.itemCountForTab(s.TabIndex)
125 1 : if count == 0 {
126 1 : return s
127 1 : }
128 1 : next := (s.ItemIndex + 1) % count
129 1 : return TabMenuState{TabIndex: s.TabIndex, ItemIndex: n.skipNext(s.TabIndex, next, 1)}
130 : }
131 :
132 : // left はページを1つ前へ繰る。ページ送りが無効か先頭ページなら何もしない
133 : func (n *tabMenuNav) left(s TabMenuState) TabMenuState {
134 1 : if n.config.ItemsPerPage > 0 && s.ItemIndex >= n.config.ItemsPerPage {
135 1 : return TabMenuState{TabIndex: s.TabIndex, ItemIndex: n.skipNext(s.TabIndex, s.ItemIndex-n.config.ItemsPerPage, 1)}
136 1 : }
137 1 : return s
138 : }
139 :
140 : // right はページを1つ次へ繰る。ページ送りが無効か末尾ページなら何もしない
141 : func (n *tabMenuNav) right(s TabMenuState) TabMenuState {
142 1 : count := n.itemCountForTab(s.TabIndex)
143 1 : if n.config.ItemsPerPage > 0 && s.ItemIndex+n.config.ItemsPerPage < count {
144 1 : return TabMenuState{TabIndex: s.TabIndex, ItemIndex: n.skipNext(s.TabIndex, s.ItemIndex+n.config.ItemsPerPage, 1)}
145 1 : }
146 1 : return s
147 : }
148 :
149 : // SetTab は指定タブへ直接カーソルを移す。新タブの先頭選択可能行へカーソルを置き、範囲外はクランプする。
150 : // キー再生を避けてタブを設定する用途に使う。UseTabMenu と同じ nav ロジックを通す
151 : func SetTab(store *Store, keyPrefix string, config TabMenuConfig, tab int) {
152 1 : nav := &tabMenuNav{config: config}
153 1 : store.set(keyPrefix, nav.clamp(TabMenuState{TabIndex: tab, ItemIndex: nav.firstSelectable(tab)}))
154 1 : }
155 :
156 : // DispatchNav はカーソル移動系の Action なら Dispatch して真を返し、それ以外は何もせず偽を返す。
157 : // 呼び出し側は集合を知る必要がなく、消費されなかった Action をそのまま後続へ渡せばよい。
158 : // 消費の可否は navHandlers の所属と一致するので、reduce の実行を待たず同期的に答えられる
159 : func (m *Mount[Props]) DispatchNav(a inputmapper.ActionID) bool {
160 0 : if _, ok := navHandlers[a]; !ok {
161 0 : return false
162 0 : }
163 0 : m.Dispatch(a)
164 0 : return true
165 : }
166 :
167 : // UseTabMenu は再利用可能なタブメニュー状態管理を提供する
168 : // ReactのカスタムHooksに相当するパターンで、複数のUseStateを組み合わせる
169 : // keyPrefixは状態キーの接頭辞で、複数のタブメニューを区別するために使う
170 : // 端での循環は常に有効
171 : // ペジネーションが有効な場合、ページはitemIndexから自動計算される
172 : // タブ切り替え: Tab / Shift+Tab
173 : // ページ移動: 左右キー
174 : func UseTabMenu(store *Store, keyPrefix string, config TabMenuConfig) TabMenuState {
175 1 : nav := &tabMenuNav{config: config}
176 1 :
177 : // tabIndexとitemIndexを複合状態として管理する。
178 : // 単一のreducerでタブ切り替えとアイテム移動を原子的に処理するため、
179 : // タブ切り替え時に新タブのitemsで正しくfirstSelectableを計算できる
180 1 : init := TabMenuState{ItemIndex: nav.firstSelectable(0)}
181 1 : state := nav.clamp(UseState(store, keyPrefix, init, nav.reduce))
182 1 : // クランプ後の値をstoreに反映して、UI側が参照する値と一致させる
183 1 : store.set(keyPrefix, state)
184 1 :
185 : // ページはitemIndexから派生する値として計算
186 1 : itemCount := nav.itemCountForTab(state.TabIndex)
187 1 : if nav.config.ItemsPerPage > 0 && itemCount > 0 {
188 1 : state.Page = state.ItemIndex / nav.config.ItemsPerPage
189 1 : }
190 :
191 1 : return state
192 : }
|