Responsywność i dostępność
Wymagania dotyczące klawiatury, fokusu, dotyku i urządzeń mobilnych dla komponentów i rozszerzeń platformy Qokit.
Responsywność i dostępność
Wszystkie publicznie dostępne komponenty i interfejsy integracyjne muszą jednocześnie obsługiwać klawiaturę, dotyk oraz różne długości tekstów. Układ na urządzeniach mobilnych powinien być organizowany zgodnie z priorytetami zadań, a nie poprzez proste zmniejszanie interfejsu desktopowego.
Klawiatura i fokus
- Używaj semantycznych komponentów Button, Link, Label, Heading, Table i List;
- Wszystkie interakcje muszą być dostępne i sterowalne za pomocą klawiatury;
- Korzystaj z udostępnionych
focus-visibleoraz--focus-ring, nie usuwaj wizualnej informacji o fokusie; - IconButton musi dostarczać zlokalizowany
aria-label; - Tooltip służy wyłącznie jako uzupełnienie, nie może zastępować nazwy dostępności.
Dotyk i stany
- Obszar kliknięcia kompaktowych kontrolek musi mieć co najmniej 40px, a głównych akcji na urządzeniach mobilnych co najmniej 44px;
- Hover nie może być jedyną formą wskazania interakcji;
- Stany Disabled, Loading, Empty i Error muszą zapewniać zrozumiałe informacje zwrotne;
- Akcje ryzykowne wymagają wyraźnego tekstu i procedury potwierdzenia, nie można polegać wyłącznie na kolorze czerwonym.
Układ responsywny
- Interfejsy wielokolumnowe poniżej rozmiaru tabletu powinny przełączać się na układ jednokolumnowy, zwijać elementy lub używać paneli bocznych (drawer) zgodnie z priorytetem zadań;
- Header, Toolbar, tabele, okna podglądu i grupy akcji muszą zachować stabilne wymiary;
- Długie etykiety, teksty przetłumaczone oraz treści generowane przez użytkowników nie mogą zasłaniać sąsiednich akcji;
- Należy zweryfikować rzeczywiste treści, kolejność fokusu oraz poziome przepełnienie zarówno na desktopie, jak i na urządzeniach mobilnych.
Treść i kontrast
- Tekst główny, opisy i CTA muszą pozostawać czytelne na jasnym, ciemnym oraz zmotywowanym tle;
- Obrazy muszą posiadać tekst alternatywny odpowiadający ich treści;
- Stanów nie można wyrażać wyłącznie za pomocą kolorów;
- Animacje muszą szanować
prefers-reduced-motion, a kluczowe procesy nie mogą polegać na ukończeniu animacji.