Skip to Content
Design

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-visible e --focus-ring compartilhados, não remova o feedback de foco;
  • IconButton deve fornecer aria-label localizado;
  • 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.

Nesta página