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