Responsividade e Acessibilidade
Requisitos de teclado, foco, toque e mobile para componentes e extensões de plataforma do Qokit.
Responsividade e Acessibilidade
Todos os componentes públicos e interfaces de integração devem suportar simultaneamente teclado, toque e diferentes comprimentos de idioma. No mobile, o layout deve ser reorganizado por tarefa, em vez de simplesmente reduzir a interface desktop.
Teclado e Foco
- Use elementos semânticos Button, Link, Label, Heading, Table e List;
- Todas as interações devem ser alcançáveis e operáveis via teclado;
- Utilize
focus-visiblee--focus-ringcompartilhados, não remova o feedback de foco; - IconButton deve fornecer
aria-labellocalizado; - Tooltip serve apenas para complementar informações, não substituindo o nome acessível.
Toque e Estados
- A área de clique de controles compactos não deve ser inferior a 40px, e as operações principais no mobile não devem ser inferiores a 44px;
- Hover não pode ser a única indicação;
- Os estados Disabled, Loading, Empty e Error devem ter feedback compreensível;
- Operações perigosas usam texto explícito e fluxo de confirmação, não dependendo apenas da cor vermelha.
Layout Responsivo
- Em telas menores que tablet, layouts em colunas alternam para coluna única, recolhidos ou drawer com base na prioridade da tarefa;
- Header, Toolbar, tabela, caixa de pré-visualização e grupo de ações mantêm tamanho estável;
- Etiquetas longas, textos traduzidos e conteúdo do usuário não devem cobrir ações adjacentes;
- Valide conteúdo real, ordem de foco e overflow horizontal tanto no desktop quanto no mobile.
Conteúdo e Contraste
- Texto principal, explicações e CTA devem permanecer legíveis em fundos claros, escuros e temáticos;
- Imagens fornecem texto alternativo adequado ao conteúdo;
- Estados não podem ser expressos apenas por cores;
- Animações respeitam
prefers-reduced-motion, fluxos críticos não dependem de animações para conclusão.