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
O hover escurece; o foco acrescenta um anel de 3 px
Não recebe foco; a WCAG não exige contraste dele
Continua focável, os cliques são ignorados
O hover escurece; o foco acrescenta um anel de 3 px
Não recebe foco; a WCAG não exige contraste dele
Continua focável, os cliques são ignorados
O hover escurece; o foco acrescenta um anel de 3 px
Não recebe foco; a WCAG não exige contraste dele
Continua focável, os cliques são ignorados
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 componentebutton.primary.padding-inlinede Níveis de tokens, apontando paraspace.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
disableddo 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 dedisabled, 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
Terminal de Ferry de Kestrel Bay, Cais Norte → Porto Velho da Ilha de Mara
No horário09:40 · 50 min · sex., 4 de dez.
Kestrel Bay → Insel Mara
Pünktlich09:40 · 50 Min. · Freitag, 4. Dezember
Kestrel Bay → Ilha de Mara
09:40 · 50 min · sex., 4 de dez.
Kestrel Bay → Ilha de Mara
Cancelado09:40 · 50 min · sex., 4 de dez.
Não conseguimos carregar este bilhete
Confira sua conexão. Sua reserva está garantida.
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
disabledpara 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)
- Escolha um componente num produto que você conhece, como um item de lista ou um card.
- Escreva os estados dele numa grade: estados de interação na horizontal, variantes na vertical. Quais células existem hoje?
- 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
- W3C: APG, Button pattern · Understanding 4.1.3 Status Messages · Understanding 1.4.10 Reflow · Text size in translation
- GOV.UK Design System, Button: botões desativados e cliques duplos
- MDN: aria-disabled · prefers-reduced-motion
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