반응형 및 접근성
Qokit 컴포넌트 및 플랫폼 확장을 위한 키보드, 포커스, 터치 및 모바일 요구사항.
반응형 및 접근성
모든 공개 컴포넌트 및 통합 인터페이스는 키보드, 터치 및 다양한 언어 길이를 동시에 지원해야 합니다. 모바일에서는 데스크톱 인터페이스를 단순히 축소하는 것이 아닌, 작업 단위에 따라 레이아웃을 재구성해야 합니다.
키보드 및 포커스
- 시맨틱 Button, Link, Label, Heading, Table 및 List를 사용하십시오;
- 모든 상호작용은 키보드로 접근하고 조작할 수 있어야 합니다;
- 공유
focus-visible및--focus-ring를 사용해야 하며, 포커스 피드백을 제거해서는 안 됩니다; - IconButton에는 로컬라이징된
aria-label를 반드시 제공해야 합니다; - Tooltip은 보조 설명용으로만 사용되며 접근 가능한 이름(accessibility name)을 대체할 수 없습니다.
터치 및 상태
- 컴팩트 컨트롤의 클릭 영역은 최소 40px 이상이어야 하며, 모바일 주요 작업은 최소 44px 이상이어야 합니다;
- Hover는 유일한 힌트가 될 수 없습니다;
- Disabled, Loading, Empty 및 Error 상태에는 이해 가능한 피드백이 있어야 합니다;
- 위험한 작업은 명확한 문구와 확인 절차를 사용해야 하며, 빨간색에만 의존해서는 안 됩니다.
반응형 레이아웃
- 태블릿 이하의 다중 열 인터페이스는 작업 우선순위에 따라 단일 열, 접힘 또는 서랍(drawer)으로 전환해야 합니다;
- Header, Toolbar, 테이블, 미리보기 창 및 작업 그룹은 안정된 크기를 유지해야 합니다;
- 긴 라벨, 번역 텍스트 및 사용자 콘텐츠가 인접한 작업을 덮어서는 안 됩니다;
- 데스크톱과 모바일 모두 실제 콘텐츠, 포커스 순서 및 가로 오버플로를 검증해야 합니다.
콘텐츠 및 대비
- 본문, 설명 및 CTA는 라이트 모드, 다크 모드 및 테마화된 배경에서 가독성을 유지해야 합니다;
- 이미지에는 콘텐츠와 일치하는 대체 텍스트(alternative text)를 제공해야 합니다;
- 상태는 색상만으로 표현되어서는 안 됩니다;
- 애니메이션은
prefers-reduced-motion를 존중해야 하며, 핵심 프로세스는 애니메이션 완료에 의존해서는 안 됩니다.