Framework · Design systems · 4 min de leitura
Matriz de estados do componente
Uma grade com todos os estados que um componente precisa ter (os de interação, que o navegador define; os de componente, que o produto define; os de dados, que o conteúdo traz) contra o que cada um precisa: um design, o atributo certo, um contraste medido e um teste de caso-limite.
Definidos pelo navegador, a partir do que a pessoa faz.
Hover, foco, pressionadoDefinidos pelo produto, por uma prop.
Desativado, carregando, selecionado, erroDefinidos pelo conteúdo que o componente recebe.
Vazio, longo, ausente, falhouUm frame real para cada estado, em cada modo.
Ao lado das variantesO atributo, para onde vai o foco, o que é anunciado.
Carregando mantém o focoContraste medido por estado, mais um teste com conteúdo real.
4,5:1 texto, 3:1 anelCada estado (linhas I, C, D) × cada necessidade (colunas 1, 2, 3) = nenhuma célula vazia no lançamento
Use quando
- Um componente está para ser lançado e você precisa saber se está completo.
- Os bugs que voltam são de foco, de carregamento ou de texto longo, não da aparência padrão.
- Dois produtos fizeram o mesmo componente e tratam desativado ou vazio de formas diferentes.
Como usar
- Liste as linhas: todos os estados, por quem define. Os de interação vêm da pessoa (hover, foco, pressionado). Os de componente vêm de uma prop (desativado, carregando, selecionado, erro). Os de dados vêm do conteúdo (vazio, longo, ausente, falhou). Resultado: as linhas da matriz.
- Acrescente as colunas: o que cada estado precisa. Use quatro: o design (um frame real), o comportamento (atributo, foco, o que é anunciado), o contraste medido em cada modo e o teste (uma story ou um frame com conteúdo real). Resultado: uma grade vazia.
- Preencha o comportamento a partir do padrão, não de memória. Desativado usa o atributo HTML
disablede sai da ordem do Tab. Carregando usaaria-disabled="true", mantém o foco no elemento e ignora cliques. Uma ação concluída é anunciada com uma mensagemrole="status". Resultado: a coluna de comportamento, com as fontes. - Meça todo estado que tem texto ou contorno. Texto precisa de 4,5:1 e anel de foco de 3:1. A WCAG não exige contraste de um componente inativo, então texto desativado legível é escolha sua. Anote, de um jeito ou de outro. Resultado: uma razão por estado e por modo.
- Teste as linhas de dados com conteúdo real. Nomes longos, rótulos traduzidos, valores ausentes, um carregamento que falha, zoom de 200% e uma tela de 320 px de largura. Decida parte por parte: quebrar linha, truncar com o texto completo disponível ou limitar na entrada. Resultado: um frame ou uma story por caso-limite.
- Entregue a matriz junto com o componente. Ponha os frames na página do componente no Figma e os casos no Storybook. Um estado que só existe na cabeça de alguém não foi desenhado. Resultado: nenhuma célula vazia no lançamento.
Exemplo
O Button do Harbour antes do lançamento, no modo claro. Os números são os medidos na lição.
| Estado | Definido por | Comportamento | Contraste | Testado com |
|---|---|---|---|---|
| Repouso, primary | Componente | Padrão | 6,35:1 | "Reservar travessia" |
| Hover | Navegador | Preenchimento mais escuro | 8,86:1 | Só ponteiro |
| Foco | Navegador | Anel por fora do botão | Anel 8,35:1 sobre a página | Teclado, Tab |
| Desativado | Produto, disabled |
Sai da ordem do Tab; motivo ao lado | 4,92:1 (uma escolha) | "Escolha uma saída primeiro" |
| Carregando | Produto, aria-disabled |
Mantém o foco, ignora cliques, depois uma mensagem de status | Igual ao repouso | Clique duplo |
| Rótulo longo | Conteúdo | Quebra linha; espaço para o dobro do tamanho em inglês | Igual ao repouso | Um rótulo de 12 caracteres traduzido |
| Compacto | Prop size |
32 px de altura, acima do alvo mínimo de 24 px | Igual ao repouso | Console da equipe |
As células vazias que o time achou: nenhum design para carregando no modo escuro, e nenhum teste com rótulo traduzido. As duas foram resolvidas antes do lançamento.
Cuidado com
- Só o estado em repouso desenhado. Hover, foco e desativado ficam para o desenvolvimento, e cada produto faz de um jeito.
disabledpara carregando. O foco pula para longe no meio da ação, e quem usa teclado perde o lugar.- Contraste conferido uma vez. O repouso passa, o hover ou o desativado não, e ninguém mediu.
- "Lorem ipsum" e só inglês. Rótulos curtos são os que mais crescem na tradução, e texto de exemplo nunca tem o nome longo do porto que quebra o card.
Modelo
Copie uma grade por componente. Não deixe célula vazia no lançamento: escreva "n/a" com o motivo.
Componente: ... Modos: claro / escuro
Estado | Definido por | Frame | Comportamento (atributo, foco, anunciado) | Contraste claro / escuro | Teste (story / frame)
Repouso | componente | ... | ... | ... / ... | ...
Hover | navegador | ... | ... | ... / ... | ...
Foco | navegador | ... | anel, visível em qualquer fundo | anel ... / ... | teclado
Pressionado | navegador | ... | ... | ... / ... | ...
Desativado | prop | ... | disabled, motivo visível | ... / ... | ...
Carregando | prop | ... | aria-disabled, foco mantido, status | ... / ... | clique duplo
Erro | prop | ... | ... | ... / ... | ...
Vazio | conteúdo | ... | parte escondida, nunca "undefined" | n/a | ...
Longo | conteúdo | ... | quebra / trunca + texto completo / limite | ... / ... | texto longo real
Traduzido | conteúdo | ... | espaço para crescer | ... / ... | ...
200% / 320 px | conteúdo | ... | refaz o layout, sem rolagem lateral | ... / ... | ...
- Inclusive ComponentsHeydon PickeringLivro · 2019 (Amazon)
- Button patternWAI-ARIA APG (site externo)
- Understanding 4.1.3 Status MessagesW3C (site externo)
- Text size in translationW3C (site externo)
- ButtonGOV.UK Design System (site externo)
Os links "Ver na Amazon" são de afiliado: como associado, recebo por compras qualificadas, sem custo a mais para você.