Marcus Andrey Estudo
Read in English Biblioteca

Design systems · Passo 3 · 9 min de leitura

Estados e casos-limite

Um componente não está pronto quando a versão feliz fica bonita. Todo componente do Harbour tem estados de interação que o navegador define e estados de dados que o produto define, e mais os casos-limite que o conteúdo real traz: nomes longos, traduções, dados faltando, erros. Um botão de verdade com o CSS exato, os números de contraste e uma lista para desenhar contra ela.

A versão feliz de um componente é a que você menos vai ver. No mockup, todo bilhete está no horário, todo nome é curto e a rede nunca cai. Em produção, o nome de um porto em alemão quebra em três linhas, uma travessia é cancelada às 6h e o celular de alguém perde o sinal no cais. Um componente de sistema precisa ter resposta para tudo isso, desenhada uma vez, para nenhum time de produto improvisar à meia-noite.

O que você vai conseguir fazer depois de ler:

  • Diferenciar estados de interação de estados de dados, e quem define cada um
  • Colocar hover, foco, desativado e carregando num componente, com CSS de verdade
  • Medir o contraste de todos os estados, não só o de repouso
  • Listar os casos-limite que um componente precisa aguentar, e desenhá-los antes da release

1. Dois tipos de estado

Quem define Exemplos Onde é tratado
Estados de interação O navegador, a partir do que a pessoa faz Hover, foco, pressionado Estados interativos: hover, pressionado, foco
Estados do componente O produto, por uma prop Desativado, carregando, selecionado, erro Esta lição
Estados de dados O conteúdo Vazio, longo, faltando, com falha Esta lição, e Estados da interface: vazio, carregando, erro, sucesso

O curso de Motion explica como hover, pressionado e foco devem parecer e com que rapidez devem aparecer. Aqui a pergunta é outra: o que o sistema precisa entregar para todo produto acertar os estados sem desenhá-los de novo?


2. Um botão, todos os estados

primary · Repouso: passe o mouse, chegue com Tab

O hover escurece; o foco acrescenta um anel de 3 px

Desativado

Não recebe foco; a WCAG não exige contraste dele

Carregando

Continua focável, os cliques são ignorados

secondary · Repouso: passe o mouse, chegue com Tab

O hover escurece; o foco acrescenta um anel de 3 px

Desativado

Não recebe foco; a WCAG não exige contraste dele

Carregando

Continua focável, os cliques são ignorados

danger · Repouso: passe o mouse, chegue com Tab

O hover escurece; o foco acrescenta um anel de 3 px

Desativado

Não recebe foco; a WCAG não exige contraste dele

Carregando

Continua focável, os cliques são ignorados

Três variantes do Button do Harbour nos estados que toda variante precisa ter. A primeira coluna é de verdade: passe o mouse, ou aperte Tab até ela receber o foco. O desativado usa o atributo disabled de verdade; o carregando usa aria-disabled="true", então continua na ordem do Tab. Com o movimento reduzido ligado, o spinner para e vira um anel pontilhado. CSS de verdade, as regras exatas da lição.

Estas são as regras que rodam na figura, exatamente. As cores vêm dos tokens do Harbour, definidos por modo num bloco separado; cada variante só define três tokens de componente.

.ds-b-btn {
  display: inline-flex; align-items: center; justify-content: center; gap: var(--hb-space-2);
  min-height: 44px; padding-block: var(--hb-space-2); padding-inline: var(--hb-space-5);
  border: 2px solid transparent; border-radius: var(--hb-radius-control);
  background: var(--hb-button-background); color: var(--hb-button-text);
  font: 600 var(--hb-font-size-300)/1.2 var(--text); cursor: pointer;
  transition: background-color 100ms linear, border-color 100ms linear;
}
@media (hover: hover) {
  .ds-b-btn:hover { background: var(--hb-button-background-hover); }
}
.ds-b-btn:focus-visible { outline: 3px solid var(--hb-color-focus); outline-offset: 2px; }
.ds-b-btn:disabled { background: var(--hb-color-disabled-surface); border-color: transparent; color: var(--hb-color-disabled-text); cursor: not-allowed; }
.ds-b-btn[aria-disabled="true"] { background: var(--hb-button-background); cursor: progress; }
.ds-b-btn__spin { width: 1em; height: 1em; border: 2px solid currentColor; border-right-color: transparent; border-radius: 50%; animation: ds-b-spin 800ms linear infinite; }
@keyframes ds-b-spin { to { transform: rotate(1turn); } }
@media (prefers-reduced-motion: reduce) {
  .ds-b-btn { transition: none; }
  .ds-b-btn__spin { animation: none; border-style: dotted; border-right-color: currentColor; }
}

/* variants: each one only sets the component tokens */
.ds-b-btn--primary   { --hb-button-background: var(--hb-color-action-primary); --hb-button-background-hover: var(--hb-color-action-primary-hover); --hb-button-text: var(--hb-color-on-action); }

Três coisas nesse código são decisões do sistema, não estilo:

  • padding-inline: var(--hb-space-5) é o token de componente button.primary.padding-inline de Níveis de tokens, apontando para space.5, 24 px. Ninguém digita 24.
  • O hover fica dentro de @media (hover: hover), então os celulares não ganham um hover que gruda depois do toque (MDN, hover media feature).
  • O movimento reduzido faz parte do componente. Com prefers-reduced-motion: reduce, o spinner para e vira um anel pontilhado (MDN, prefers-reduced-motion). As palavras "Reservando…" continuam dizendo o que está acontecendo, então nada se perde.

3. Desativado e carregando não são a mesma coisa

Os dois dizem "agora não", mas se comportam de um jeito diferente, e a diferença importa para quem usa teclado e leitor de tela.

  • Desativado usa o atributo disabled do HTML. O botão sai da ordem do Tab e não pode ser pressionado. O GOV.UK Design System é direto: botões desativados têm contraste ruim e podem confundir algumas pessoas, então evite quando puder (GOV.UK, Button). A regra do Harbour: prefira um botão ativo que explica o que está faltando quando é pressionado; se precisar desativar, diga o motivo ao lado.
  • Carregando usa aria-disabled="true". O padrão de botão do WAI-ARIA usa esse atributo quando a ação do botão não está disponível (APG, Button pattern), e, diferente de disabled, ele não tira o elemento da ordem de foco (MDN, aria-disabled). O foco continua no botão, e a pessoa não é jogada para o topo da página. O componente ignora os cliques enquanto carrega, o que também evita reservas em dobro. O GOV.UK conta a mesma história da vida real: o time do Notify descobriu pessoas recebendo convites duas vezes porque quem enviava clicava duas vezes no botão de enviar.

Quando a reserva termina, avise com uma mensagem de status, uma região com role="status" que o leitor de tela anuncia sem mover o foco (W3C, Understanding 4.1.3 Status Messages).


4. Meça todos os estados

O contraste é conferido no botão em repouso e depois esquecido. Todo estado que tem texto ou uma borda precisa do seu número. Estes são os do Harbour, medidos com a fórmula da WCAG:

Estado Modo claro Modo escuro
Primary, repouso Branco sobre blue.600 #1F5FAE: 6,35:1 ink.900 sobre blue.400 #5B95DB: 5,32:1
Primary, hover Branco sobre blue.700 #174A88: 8,86:1 ink.900 sobre #8AB4E8: 7,69:1
Danger, repouso Branco sobre coral.600 #C2412D: 5,14:1 ink.900 sobre #E0705E: 5,23:1
Anel de foco contra a página #174A88 sobre sand.50: 8,35:1 #8AB4E8 sobre ink.900: 7,69:1
Rótulo desativado #56636F sobre #E3E6E9: 4,92:1 #9AA7B3 sobre #2A3642: 5,02:1

Texto precisa de 4,5:1, e o anel de foco, como componente de interface, precisa de 3:1 (W3C, Understanding 1.4.3; Understanding 1.4.11). A WCAG não exige contraste de um componente de interface inativo, então a linha do desativado é uma escolha: o Harbour mantém o texto legível mesmo assim, porque as pessoas ainda precisam ler o que não podem pressionar.


5. Casos-limite: o que o conteúdo real faz

Nomes longosQuebra a linha; nunca corta com reticências

Terminal de Ferry de Kestrel Bay, Cais Norte → Porto Velho da Ilha de Mara

No horário

09:40 · 50 min · sex., 4 de dez.

Passageiros
2 adultos
TraduzidoEm alemão os rótulos ficam ainda mais longos; o layout abre espaço

Kestrel Bay → Insel Mara

Pünktlich

09:40 · 50 Min. · Freitag, 4. Dezember

Fahrgäste
2 Erwachsene
Dados faltandoSem veículo e ainda sem status: as partes somem, nunca aparece "undefined"

Kestrel Bay → Ilha de Mara

09:40 · 50 min · sex., 4 de dez.

CanceladoO status em palavras, não só na cor; e um caminho para seguir

Kestrel Bay → Ilha de Mara

Cancelado

09:40 · 50 min · sex., 4 de dez.

Passageiros
2 adultos
CarregandoUm skeleton do mesmo tamanho do card, para nada pular
Falha ao carregarDiz o que aconteceu e o que fazer

Não conseguimos carregar este bilhete

Confira sua conexão. Sua reserva está garantida.

Um componente, seis situações que ele vai encontrar em produção. O card feliz é o fácil; estes são os que precisam de uma decisão escrita na documentação. Cada card aqui é a mesma marcação do Ticket card com conteúdo diferente.

Os estados de interação são iguais em todo produto. Os casos-limite dependem do conteúdo, e é neles que os componentes quebram. Os que todo componente do Harbour testa:

  • Conteúdo longo. Nomes reais de portos, nomes longos de passageiros, erros de três linhas. Decida para cada parte: quebra a linha, corta com o texto completo disponível, ou limita na entrada. As rotas sempre quebram a linha.
  • Tradução. Os textos curtos são os que mais crescem. O W3C cita os números da IBM: um texto de até 10 caracteres em inglês pode ficar com 200 a 300% do tamanho em outra língua, e um texto com mais de 70 caracteres, cerca de 130% (W3C Internationalization, Text size in translation). Um rótulo de botão de 12 caracteres precisa de espaço para uns 24.
  • Dados faltando. Sem veículo, ainda sem status, sem assento. A parte some; nunca aparece "undefined", "null" ou um rótulo vazio.
  • Carregando e falha. Um skeleton do tamanho do card real, para nada pular; um erro que diz o que aconteceu e o que fazer. Feedback durante a espera trata do tempo.
  • Zoom e telas pequenas. O texto precisa funcionar a 200% (Understanding 1.4.4) e o conteúdo precisa se reorganizar numa largura de 320 pixels CSS sem rolagem para o lado (Understanding 1.4.10).
  • Densidade. O tamanho compacto do console da equipe, com 32 px de altura: ainda acima do alvo mínimo de 24 por 24 px da WCAG 2.2 (Understanding 2.5.8).

Coloque tudo isso na página do componente no Figma, como frames de verdade ao lado das variantes, e no Storybook como stories (veja Storybook e documentação viva). Um caso-limite que só existe na cabeça de alguém não foi desenhado.


6. Erros comuns

  • Desenhar só o estado de repouso e deixar hover, foco e desativado para o desenvolvedor.
  • Usar disabled para carregando, e o foco pula para longe no meio da ação.
  • Um spinner que continua girando com movimento reduzido, ou um spinner sem palavras.
  • Conferir o contraste só do estado de repouso.
  • Testar com "Lorem ipsum" e só em inglês.
  • Mostrar "undefined" ou uma linha vazia quando faltam dados.

7. Vocabulário

Termo Significado
Estado de interação Um estado que o navegador define: hover, foco, pressionado
Estado do componente Um estado que o produto define por uma prop: desativado, carregando, selecionado
aria-disabled Diz à tecnologia assistiva que um controle está indisponível, sem tirá-lo da ordem do Tab
Mensagem de status Uma mudança que o leitor de tela anuncia sem mover o foco, geralmente com role="status"
Caso-limite Conteúdo ou condição no extremo: muito longo, faltando, com falha, com zoom
Skeleton Um espaço reservado cinza no formato do conteúdo que está carregando

8. Experimente (sem ferramentas)

  1. Escolha um componente num produto que você conhece, como um item de lista ou um card.
  2. Escreva os estados dele numa grade: estados de interação na horizontal, variantes na vertical. Quais células existem hoje?
  3. Agora escreva cinco casos-limite para ele, usando a lista da seção 5. Esboce o pior.

Perguntas para refletir: Que estado o seu time desenha por último? Se a rede caísse agora, o que o seu componente mais usado mostraria?


9. Se você já pratica

  • Crie uma página de "estados e casos-limite" para cada componente no Figma, e uma story por estado no código.
  • Mantenha um conjunto de conteúdo de teste: os nomes reais mais longos, um texto traduzido, um registro vazio, uma requisição com falha.
  • Registre o contraste de cada estado na documentação do componente, nos dois modos, para ninguém precisar medir de novo.
  • Revise o comportamento de carregamento com um leitor de tela: o foco fica no lugar, e o resultado é anunciado?

Checklist

Para saber mais

Livros, cursos e vídeos para ir mais fundo

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

Relacionadas

Variantes, propriedades e slots · Composição em vez de configuração · Estados interativos: hover, pressionado, foco · Estados da interface: vazio, carregando, erro, sucesso · Feedback durante a espera · Níveis de tokens · Storybook e documentação viva · Componentes acessíveis · Matriz de estados do componente

Salvo só neste dispositivo.

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