Marcus Andrey Estudo
Read in English Biblioteca

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.

IInteração

Definidos pelo navegador, a partir do que a pessoa faz.

Hover, foco, pressionado
CComponente

Definidos pelo produto, por uma prop.

Desativado, carregando, selecionado, erro
DDados

Definidos pelo conteúdo que o componente recebe.

Vazio, longo, ausente, falhou
1Design

Um frame real para cada estado, em cada modo.

Ao lado das variantes
2Comportamento

O atributo, para onde vai o foco, o que é anunciado.

Carregando mantém o foco
3Número

Contraste medido por estado, mais um teste com conteúdo real.

4,5:1 texto, 3:1 anel

Cada estado (linhas I, C, D) × cada necessidade (colunas 1, 2, 3) = nenhuma célula vazia no lançamento

Os três tipos de estado de um componente, e as três coisas que cada estado precisa antes de o componente ser lançado.

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

  1. 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.
  2. 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.
  3. Preencha o comportamento a partir do padrão, não de memória. Desativado usa o atributo HTML disabled e sai da ordem do Tab. Carregando usa aria-disabled="true", mantém o foco no elemento e ignora cliques. Uma ação concluída é anunciada com uma mensagem role="status". Resultado: a coluna de comportamento, com as fontes.
  4. 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.
  5. 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.
  6. 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.
  • disabled para 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       | ... / ...                | ...
Fonte
Padrão de botão e aria-disabled: W3C, WAI-ARIA Authoring Practices Guide. Contraste, mensagens de status, reflow e tamanho do alvo: W3C, Understanding WCAG 2.2 (1.4.3, 1.4.11, 4.1.3, 1.4.10, 2.5.8). Crescimento do texto na tradução: W3C Internationalization
Onde encontrar
Design systems na prática: Estados e casos-limite › Dois tipos de estado

Os links "Ver na Amazon" são de afiliado: como associado, recebo por compras qualificadas, sem custo a mais para você.

Salvo só neste dispositivo.

↑ ↓ para mover · Enter para abrir · Esc para fechar