22 lines
8.1 KiB
Markdown
22 lines
8.1 KiB
Markdown
# 06. 토큰·프리미티브·컴포넌트·기능 우선 검토
|
|
|
|
이 문서는 조작과 접근성 검토를 보관한다. 현재 먼저 진행할 시각 개선의 범위는 [심미성 중심 검토](07-visual-design-review.md)에 있다.
|
|
|
|
기준은 `f649490`의 현재 웹 소스와 기존 브라우저 감사다. 먼저 **액션과 링크의 대비, 경기 분석 탭의 키보드 동작, 경매 확인창의 포커스**를 개선한다. 이 세 항목은 참가·경매·코드 발급 상태를 해석하거나 전적 API를 바꾸지 않고 검증할 수 있다. 실제 화면에서 재현한 사례와 코드에서 발견한 위험을 아래에서 구분했다. [기존 디자인 시스템 감사](03-design-system.md)
|
|
|
|
| 순서 | 영역 | 현재 증거 | 변경 후보와 통과 조건 |
|
|
| --- | --- | --- | --- |
|
|
| 1 | 디자인 토큰 | 이전 브라우저 계측값의 sRGB 근사치로 라이트 코랄 링크/흰 표면은 약 3.27:1, 코랄 버튼/밝은 글자는 약 3.08:1이다. 다크 기본 primary 버튼 조합도 약 4.14:1이었다. 실제 배경 합성과 상호작용 상태는 적용 후 측정해야 한다. | `action` 버튼 전경·배경, `link` 전경, `focus` 링을 독립 토큰으로 정의한다. 홈의 전적 링크, 경기 분석의 선택 탭·포커스, 개인 전적의 갱신 버튼에 먼저 적용한다. 라이트·다크에서 일반 크기 글자 4.5:1, 기능을 식별하는 경계·선택 표시 3:1을 해당 표면에서 확인한다. 선택과 포커스는 서로 구분된다. [CSS](../../apps/web/src/index.css#L103) · [갱신 버튼](../../apps/web/src/pages/UserHistoryPage.tsx#L1363) · [WCAG 2.2](https://www.w3.org/TR/WCAG22/#contrast-minimum) |
|
|
| 2 | `Tabs` 프리미티브 | 내전 상세에서는 좌우·Home/End 키와 `tabIndex` 이동이 구현돼 있다. 경기 분석 탭에서는 브라우저에서 방향키가 동작하지 않았고 버튼 3개가 모두 Tab 순서에 들어갔다. | 내전 상세의 키보드 패턴을 기준으로 분석 탭을 고친다. 탭 그룹에는 한 번의 Tab으로 진입하고 좌우·Home/End로 이동한다. 선택 탭과 패널을 연결한다. 내전 상세의 sticky 위치, URL 및 스크롤 보정은 해당 화면에 둔다. 경매 탭은 분석 탭 검증 후 적용 여부를 결정한다. [내전 상세 탭](../../apps/web/src/components/competition/MatchDetailTabBar.tsx#L46) · [분석 탭](../../apps/web/src/components/InternalGameAnalysisTabs.tsx#L954) · [WAI-ARIA Tabs](https://www.w3.org/WAI/ARIA/apg/patterns/tabs/) |
|
|
| 3 | `Dialog` 프리미티브 | 기존 브라우저 감사에서 경매 취소창을 Escape로 닫은 뒤 포커스가 트리거로 돌아가지 않았다. 취소·되돌리기·참여자 추가는 각각 모달 컨테이너를 구현한다. | 경매 취소·되돌리기부터 초기 포커스, 모달 안의 Tab 이동, Escape, 닫힌 뒤 포커스 복귀를 검증한다. 진행 중 요청이 있을 때 닫기 동작을 일관되게 한다. 키보드만으로 열기·확인 입력·닫기까지 수행할 수 있다. 같은 동작이 안정되면 참여자 추가에 재사용한다. [경매 모달](../../apps/web/src/pages/AuctionPage.tsx#L2466) · [참여자 모달](../../apps/web/src/pages/MatchDetailPage.tsx#L751) · [WAI-ARIA Dialog](https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/) |
|
|
| 4 | 세트 선택 컴포넌트·기능 | 390px 화면에서 약 300px 영역에 세트 링크 2,048px가 들어갔다. 현재 링크는 색으로만 구분하고 `aria-current`를 제공하지 않는다. | 현재 세트와 이전·다음, 전체 목록 열기를 좁은 화면에서 우선 제공한다. 기존 게임 링크와 선택 규칙을 사용한다. 예를 들어 기록이 1·2·7이면 2의 다음은 존재하는 7이다. 현재 링크는 `aria-current="page"`와 눈에 보이는 선택 표시를 갖는다. [세트 선택 코드](../../apps/web/src/pages/MatchGameDetailPage.tsx#L1505) · [390px 캡처](evidence/L26-mobile-game.jpg) |
|
|
| 5 | 통계 상태 컴포넌트·기능 | 인사이트 미응답을 `?? 0`으로 렌더하고, 순위 응답이 없으면 빈 배열을 넘긴다. 스테이징 값의 정상 여부와 무관하게 로딩·실패·빈 데이터가 같은 표현을 공유하는 분기가 있다. | 최근 내전·선수 순위·하이라이트에 각자의 `불러오는 중`, `조회 실패`, `이 조건에 기록 없음`, `표본 부족`을 제공한다. 실제 0%는 유효한 분모가 확인될 때만 표시한다. 다른 섹션을 유지하며 실패한 영역만 다시 요청한다. 첫 작업은 현재 query 상태로 할 수 있는 분리부터 적용한다. 승패 유효 분모가 추가로 필요하면 통계 계약에서 확인한다. [현재 코드](../../apps/web/src/pages/CommunityInternalStatsPage.tsx#L349) |
|
|
| 6 | `Tooltip`·`Popover`, 아이템 및 랭크 | 아이템은 hover/focus에서 설명을 띄우지만 명시적인 터치·Escape 처리 경로가 없다. 아이템마다 Tab으로 들어가고 랭크는 별도의 `data-tip`을 사용한다. 터치와 키보드의 실제 영향은 확인 대상이다. | 빌드 패널에서 아이템 이름과 필수 정보를 터치·키보드로 열고 Escape로 닫을 수 있게 한다. 여러 아이템이 있는 표에서 Tab 이동이 과도하게 늘어나는지도 확인한다. 스타일만 비슷한 랭크 배지를 즉시 같은 동작으로 묶을 필요는 없다. [아이템 동작](../../apps/web/src/components/ItemTooltip.tsx#L159) · [랭크 배지](../../apps/web/src/components/RankBadge.tsx#L44) |
|
|
| 7 | 채팅 입력 기능 | 코드에서 Shift 없는 Enter를 바로 전송하고 한글 조합 여부를 확인하는 조건이 없다. 메시지 개수가 바뀔 때 항상 맨 아래로 스크롤한다. 실제 브라우저·IME 조합은 미검증이다. | 한글 조합을 확정하는 Enter는 전송하지 않고, 일반 Enter와 Shift+Enter의 기존 의미를 유지한다. 이전 채팅을 읽을 때 새 메시지가 도착해도 위치를 보존한다. 실제 한국어 IME 및 테스트용 연결에서 확인한다. [채팅 구현](../../apps/web/src/pages/AuctionPage.tsx#L2787) |
|
|
|
|
토큰 도입 범위는 증거가 있는 용도부터 잡는다. 코랄·바이올렛·골드·시안의 원색과 대진표의 의미 팔레트는 계속 쓸 수 있다. 기존 `primary`를 한 번에 바꾸면 `.competition-series-history`의 코랄 강조와 다크 테마 계약까지 같이 바뀐다. 따라서 액션·링크의 사용처를 옮기고, 전체 알파 호환 클래스 정리, radius 전역 규칙, 타이포·간격·표면 정리는 영향을 확인하면서 뒤에 진행한다. `design-tokens.test.ts`는 원색과 CSS 매핑을 확인하므로 실제 대비 검증과 역할이 다르다. [CSS](../../apps/web/src/index.css#L81) · [기존 토큰 테스트](../../apps/web/test/design-tokens.test.ts)
|
|
|
|
공통 컴포넌트는 확인된 사용처에서 시작한다. `Button` 전면 교체 없이 액션·링크 스타일과 초점 기준을 먼저 맞출 수 있다. `Field`는 관리자 검색·티어 선택처럼 라벨과 오류 연결이 필요한 실제 사용처에서 설계한다. `Badge`는 경기 결과, 팀, 티어가 같은 색 의미를 공유하지 않도록 역할별로 나눈다. 터치 44px 목표는 주요 **조작 요소**에 적용하며 티어 배지 같은 읽기 전용 정보의 시각 크기와 구분한다. 기존 팀 코드 복사에는 44px급 높이와 라이브 피드백이 있어 동작을 재사용할 근거가 있다. [기존 복사 버튼](../../apps/web/src/components/competition/TeamTournamentCodes.tsx#L168)
|
|
|
|
첫 구현은 **액션·링크 대비와 경기 분석 Tabs**다. 같은 경기 분석 화면에서 라이트·다크, 390px와 데스크톱, 마우스·Tab·방향키를 함께 확인할 수 있다. 확인창은 입력·취소·대기·포커스 복귀 검증이 달라 다음 변경으로 검토한다. 세트 선택과 통계 상태는 이어지는 화면 내부 기능 작업이다. [결과 표시 명세](../specs/match-status-and-result-presentation.md)는 공식 데이터 연결이 필요한 별도 작업으로 보관한다. 경매 상태와 코드 발급 대기는 정상 데이터로 재현되기 전까지 관찰 항목이다.
|