Skip to content

UI調整の実施 - #29

Open
arumino-om wants to merge 9 commits into
KPC-U16:developfrom
UDHI-LAB:arumino-om/control-ui-fix
Open

arumino-om wants to merge 9 commits into
KPC-U16:developfrom
UDHI-LAB:arumino-om/control-ui-fix

Conversation

@arumino-om

Copy link
Copy Markdown
Member

概要

運営画面の入力を select 中心から選択肢を常時並べる形に置き換え、記録フォームの並びと勝因の呼称を、記録者が見たまま入力できるよう整理します。
あわせて「得点」と「スコア」の混在を解消し、開発環境を Nix で固定します。

進行中の記録は速さと確実さが要る操作ですが、select は開くまで選択肢が見えず、勝因のように6件ある項目を素早く選ぶのに向いていませんでした。
また第2戦で先攻・後攻が入れ替わっても入力欄は A・B 固定のままで、画面上の位置と実際の先後がねじれていました。

主な変更

入力UIを選択肢の一覧に置き換え

  • 共通部品 ChoiceGroup を追加。ラジオを視覚的に隠した label をカード状に並べ、選択肢とその状態を常に画面に出す
  • 記録フォームの「勝因」「勝利した参加者」「第1戦の先攻」を置き換え
  • 掲示操作の6画面をボタンの見た目のまま radio にして、選択中であることを支援技術にも伝える
  • 進行区分の select をやめて全区分を並べ、掲示中の表示にも進行区分を加える
  • 勝因に図形アイコン(ReasonIcon)を添えて一覧から探しやすくする

記録フォームを先後基準に整える

  • 先攻を左に置くよう並べ替え、配色と側表示を COOL・HOT に紐づける。どちらが先攻かを配色から読み取れるようにした
  • 勝因より先に勝者を選ぶ順に入れ替え。記録者は勝った側を先に把握しており、入力の順が観戦の順と揃う
  • 勝因を スコア比較 / 攻めによる勝ち / 相手の自滅 の3段階に分けて並べる
  • スコア比較のときの勝者選択は disabled をやめ、記録者の認識を受け取って
    算出結果と食い違う場合に警告を出す。選択値は照合のためだけに使い、保存時は捨てるため記録内容は変わらない
  • 必須でない選択を解除できるようにする

呼称の整理

「得点」の表記を「スコア」へ統一しました(画面・ドキュメント・CSV見出し)。
CHaserの競技画面ではスコアと出ているので,こちらの表記に統合しています.

キー 変更前 変更後
points 得点比較 スコア比較
put PUT 相手を埋めた
surround 相手を包囲 相手を囲んだ
disconnect 相手の通信切断 (変更なし)
illegal-move 相手の移動違反 相手が自ら壁に埋まった
self-surround 相手の自己包囲 相手が自ら周りを囲んだ

開発環境

nix develop で Node 22 / pnpm / psql / OpenSSL が揃うようにし、
pnpm は package.json の packageManager と同じ 9.12.0 を nix/pnpm.nix で固定します。
README の環境構築を Nix / Docker / 素の pnpm の3通りに整理しました。

レビューの観点

  • スコア比較時の勝者選択を「照合のみで保存しない」とした設計でよいか。入力ミスをその場で気付ける一方、選んだ値が残らない点は好みが分かれるかもしれません

確認したこと

nix develop 上で実行しています。

  • pnpm typecheck 通過
  • pnpm test 29件通過
  • pnpm format:check 通過

各コミットは1つの関心事に絞ってあり、順に追えるようにしています。
ChoiceGroup の API 追加(段組み・選択解除)と、それを使う記録フォームの変更も別コミットです。

スクショ

image image

arumino-om and others added 9 commits September 23, 2026 17:48
nix develop で Node 22 / pnpm / psql / OpenSSL が揃うようにし、
pnpm は package.json の packageManager と同じ 9.12.0 を nix/pnpm.nix で固定する。
README の環境構築を Nix / Docker / 素の pnpm の3通りに整理した。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
illegal-move の表示を「相手の移動違反」から「相手の壁埋まり」に変更する。
CHaser では壁に埋まった状態を指す呼称が使われており、記録者の認識と一致させる。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
select は開くまで選択肢が見えず、進行中に素早く選ぶ操作に向かない。
ラジオボタンを視覚的に隠した label をカード状に並べ、
選択肢とその状態を常に画面上に出す共通部品を用意する。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
勝因・勝利した参加者・第1戦の先攻を select から選択肢の並びに変える。
勝因には図形アイコンを添えて一覧から目的の項目を探しやすくし、
得点比較のときは勝者の選択を disabled にして自動判定であることを示す。
仕切り直しの開閉は text-button では押せる箇所が分かりにくいため
button subtle にし、aria-expanded で開閉状態を伝える。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
画面表示はボタンの見た目のまま radio にして選択中であることを支援技術にも伝え、
進行区分は select をやめて ChoiceGroup で全区分を並べる。
掲示中の表示に進行区分を加え、いま何が出ているかを一目で確認できるようにした。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
画面・ドキュメント・CSV見出しで「得点」と「スコア」が混在しており、
同じ値を指しているかが読み手に伝わらなかった。
CHaser の競技中に使われる呼称に合わせて「スコア」へ寄せる。
合計・換算などの修飾語はそのまま残し、語の置き換えだけに留める。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
「PUT」「相手を包囲」は競技の用語を知らない記録者には何が起きたのか読み取れず、
「相手の自己包囲」は誰の操作によるものかが曖昧だった。
主語と動作が分かる言い回しに改め、自滅系は「相手が自ら〜」で揃える。

あわせて勝因を スコア比較 / 攻めによる勝ち / 相手の自滅 の3段階に分けた
reasonGroups を加える。一列に並べると6件から目的の項目を探すことになるため、
入力側で段階ごとにまとめて示せるようにする。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
選択肢が増えると一列に並ぶだけでは関係の近い項目が読み取れないため、
sections で段ごとに分けて渡せるようにする。2段以上のときは各段を横並びにし、
段の中で選択肢が等幅になるよう grid の流し方を切り替える。

必須でない選択では選び直しはできても取り消せなかった。
onClear を受け取る場合は legend に解除ボタンを出し、
選択済みの項目をもう一度押したときも解除できるようにする。

choices と sections は排他とし、従来の呼び出し側はそのまま使える。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
入力欄の並びが常に A・B 固定で、配色も参加者ごとに決まっていたため、
第2戦で先攻・後攻が入れ替わると画面上の位置と実際の先後がねじれていた。
先攻を左に置くよう並べ替え、配色と側表示を COOL・HOT に紐づけて
どちらが先攻かを配色から読み取れるようにする。

勝因より先に勝者を選ぶ順に入れ替える。記録者は勝った側を先に把握しており、
入力の順が観戦の順と揃う。勝因は段階ごとに分けて並べる。

スコア比較のときの勝者選択は disabled をやめ、記録者の認識を受け取って
算出結果と食い違う場合に警告を出す。入力ミスをその場で気付けるようにする。
選択値は照合のためだけに使い、保存時は捨てるため記録内容は変わらない。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant