UI/UX Design
Skill pessoal. Destila com palavras próprias três livros (Lowdermilk, User-Centered Design; Yablonski, Laws of UX; Wathan e Schoger, Refactoring UI) mais NN/g, WCAG 2.2 e sistemas de design públicos. O detalhe, com fontes e o não verificado marcado, está em references/. Este ficheiro é o que se deve ter na cabeça sempre.
0. Quem manda
Quando dois conselhos colidem, ganha o de cima:
- O sistema de design e as instruções do projeto (CLAUDE.md, tokens, primitivas, guia de marca). Se o projeto diz "raio 0 e sem sombras", não se propõem sombras embora o Refactoring UI as recomende: consegue-se a profundidade com o que o sistema permite (filete, fundo, espaço). Ler os tokens e componentes existentes antes de inventar nenhum.
- Regras duras: acessibilidade WCAG 2.2 AA e não enganar o usuário. Se o sistema do projeto viola contraste ou foco, sinaliza-se com o critério WCAG e uma alternativa dentro do sistema.
- Evidência: estudos e guias com dados (NN/g, Baymard, GOV.UK, normas ISO).
- Ofício: os conselhos táticos do Refactoring UI e similares. São bons por defeito, não leis.
Dizer sempre a que nível pertence uma recomendação: "WCAG 1.4.3 (obrigatório)" não pesa o mesmo que "costuma ficar melhor assim".
1. Antes de pintar nada: a necessidade
As solicitações chegam como soluções ("adiciona exportar para CSV", "põe um botão aqui"). Por baixo há uma necessidade, e projetar a solução literal costuma dar mais superfície e pior resultado. Por isso, antes de projetar:
- Reformular a solicitação como: quando [situação], [pessoa] quer [resultado] para [motivo]. Se não se consegue preencher a situação nem o motivo, perguntar ou declarar a suposição.
- Contexto de uso (ISO 9241-11): quem, que tarefa, onde e com quê (móvel ao sol, desktop com dois ecrãs, uso diário experiente ou uma vez por ano). "Usável" não existe em abstrato: sempre para alguém, para uma tarefa, num contexto.
- Procurar o jeito atual (Excel, WhatsApp, papel): é a melhor especificação do que é preciso.
- Oferecer pelo menos uma alternativa que resolva a mesma necessidade com menos interface, se existir.
- Caminho feliz primeiro, e logo os estados: carregamento, vazio (primeira vez / por filtro / sem permissões), erro, sucesso, parcial. Uma tela sem seus estados não está projetada.
Para entrevistas, testes de usabilidade, número de usuários, métricas e SUS → references/centrado-em-usuario.md.
2. Estrutura e interação (o que mais pesa na usabilidade)
Heurísticas de Nielsen, como lista de verificação de um relance:
- Estado visível: o sistema diz o que está a acontecer (guardando, guardado, carregando, erro).
- Linguagem do usuário, não do modelo de dados.
- Controlo e liberdade: desfazer, cancelar, voltar.
- Consistência: o mesmo vê-se e comporta-se igual, e as convenções são respeitadas.
- Prevenção de erros: restrições, bons valores por defeito, aceitar formatos variados.
- Reconhecer melhor do que recordar.
- Atalhos para especialistas sem atrapalhar os novatos.
- Minimalismo: cada elemento compete com os outros.
- Erros que dizem o que aconteceu e como corrigir.
- Ajuda em contexto.
Leis de UX que mais se usam, com o seu limite:
| Lei | Aplicar | Cuidado com |
|---|---|---|
| Jakob | Padrões convencionais; inovar no valor, não na navegação | As convenções do setor (ERP, CAD) pesam mais do que as da web geral |
| Fitts | Objetos grandes e perto de onde está a atenção; botão de envio junto ao último campo | As esquinas "infinitas" só valem com rato, não em tátil |
| Hick | Menos opções onde há pressa; destacar a recomendada; revelar progressivamente | Só vale para escolher entre opções conhecidas; para procurar, manda a organização (ordem, grupos, busca) |
| Miller / memória de trabalho | Agrupar (chunking); que o sistema se lembre pelo usuário | O "7±2" não limita menus: o visível não carrega a memória. A capacidade real ronda ~4 blocos (Cowan) |
| Tesler | Que a complexidade seja absorvida pelo sistema (valores por defeito, autocompletar, cálculo) | Esconder não é simplificar: apenas desloca a complexidade |
| Postel | Aceitar formatos variados e normalizar | Aceitar não é adivinhar em silêncio: se é ambíguo, mostrar a interpretação ou perguntar |
| Peak-End | Cuidar o momento de mais valor e o fecho; vigiar os picos negativos | — |
| Von Restorff | Um único elemento destacado por zona | Se tudo destaca, nada destaca, e o destacado pode parecer um anúncio |
| Tempos de resposta | <0,1 s nada; ~1 s feedback ligeiro; 2–10 s esqueleto ou spinner; >10 s % + cancelar | O "400 ms" de Doherty não aparece no relatório original de 1982; usar 0,1/1/10 s de Nielsen |
| Goal-gradient | Progresso visível e honesto em processos longos | O progresso falso é um padrão enganoso |
As 30 leis, o mapa por situação (formulários, onboarding, checkout, tabelas, móvel…) e os maus usos → references/leyes-ux.md.
Padrões com evidência (detalhe e fontes → references/patrones.md):
- Formulários: etiqueta em cima e visível (nunca o placeholder como etiqueta); uma coluna;
autocompleteeinputmodecorretos; não partir telefone, data nem IBAN em vários campos; validar ao sair do campo ou ao enviar e remover o erro assim que corrigido ("premiar cedo, castigar tarde"); o erro junto ao campo, que diga o que aconteceu e como corrigir, com as palavras da etiqueta; conservar sempre o escrito. - Botões: verbo + objeto ("Guardar fatura", não "Aceitar"); um único botão principal por vista; evitar os desativados que não explicam o porquê (melhor deixar clicar e explicar); evitar o duplo envio.
- Destrutivo: melhor desfazer do que confirmar; confirmar apenas o irreversível, dizendo o que se perde e com botões com a ação ("Eliminar 3 faturas" / "Conservar"), não Sim/Não.
- Vazios: dizer que está vazio (e não a carregar), o que aparecerá aqui e o botão para começar; esconder filtros e ordenação enquanto não houver nada.
- Tabelas: identificador legível na primeira coluna; números à direita com
tabular-numse os mesmos decimais; cabeçalho fixo; filtros visíveis com o ativo à vista; ações de linha visíveis, não apenas ao passar o rato; alternativa ao arrasto. Em móvel: cartões para rever registos e tabela com a primeira coluna fixa para comparar. - Dashboards: uma tarefa; cada cifra com comparação, unidade e período; barras e linhas antes de tartes ou velocímetros; a cor com significado, nunca como única pista.
- Navegação: visível em desktop (o hambúrguer reduz a descoberta); em móvel, barra inferior de 3–5 destinos com ícone e texto; o frequente em zonas alcançáveis e nada crítico nas esquinas superiores.
- Microcopy: o importante nas duas primeiras palavras; remover metade das palavras; subtítulos que se possam escanear; frases curtas em voz ativa; sem "Por favor", "Oops" nem "inválido".
3. Design visual (Refactoring UI, em curto)
Detalhe com valores e CSS/Tailwind → references/diseno-visual.md (a §11 é a chuveleta).
- Começar pela funcionalidade, não pelo layout, e em escala de cinzas: se a hierarquia não funciona a cinzento, a cor não a arranja. A cor vai no final.
- Sistemas antes que valores: escalas fixas de espaçamento, tamanho de fonte, cor, sombra e raio, e decidir escolhendo nelas. Em código: tokens; nada de valores arbitrários (
p-[13px]) sem motivo. - Hierarquia com peso e cor antes que com tamanho: 2–3 tons de texto (primário, secundário, terciário) e 2 pesos (normal e semibold/bold); nada abaixo de 400. Destacar algo é muitas vezes atenuar o que compete.
- As etiquetas são o último recurso: formatos que se explicam sozinhos ("12 em stock" melhor que "Stock: 12"); se for necessária etiqueta, que pese menos que o valor. Os títulos de secção costumam funcionar como etiquetas pequenas: a hierarquia visual não tem de seguir a dos
h1…h6. - Espaçamento: começar com demasiado ar e cortar; escala não linear (4, 8, 12, 16, 24, 32, 48, 64, 96…) em que nenhum passo esteja a menos de ~25 % do seguinte; mais espaço entre grupos do que dentro de um grupo (a etiqueta colada ao seu campo).
- Larguras: não esticar a toda a tela;
max-widthpor componente; parágrafos de 45–75 caracteres; barra lateral de largura fixa e conteúdo flexível. - Texto: escala tipográfica feita à mão (12/14/16/18/20/24/30/36/48…) em px ou rem, nunca em em; entrelinha de ~1,5 no corpo e ~1–1,25 em títulos; títulos grandes com o tracking ligeiramente fechado e maiúsculas com o tracking aberto; alinhar por linha de base quando se misturam tamanhos; texto centrado apenas em 2–3 linhas.
- Cor: 8–10 cinzas (ligeiramente matizados) e 5–10 tons por cor (100–900) definidos à partida, melhor em OKLCH (luminosidade percebida uniforme); mais croma nos extremos; nunca texto cinza sobre fundo de cor (usar um tom da mesma cor); badges com contraste invertido (fundo claro matizado e texto escuro do mesmo tom); a cor nunca como único sinal.
- Botões por importância, não por semântica: principal sólido, secundário com contorno ou fundo suave, terciário como link. O destrutivo só é grande e vermelho quando é a ação principal (o botão final do diálogo de confirmação).
- Profundidade (se o sistema a admite): luz de cima; cerca de 5 sombras de duas camadas; menos bordas (separar com espaço, fundo ou sombra); borda de acento para dar cor. Sem sombras: diferenças de fundo e filetes finos.
- Imagens: os ícones não se escalam (metê-los numa forma com fundo); as imagens carregadas por usuários vão num contentor fixo com
object-fit: cover; o texto sobre uma imagem precisa de uma camada que garanta o contraste. - Modo escuro: redefinir os tokens semânticos, não inverter; superfícies que clareiam com a elevação; acentos menos saturados.
- Cifras:
font-variant-numeric: tabular-numsem tudo que se compara ou se atualiza.
4. Acessibilidade: o mínimo que não se negocia
WCAG 2.2 AA é o objetivo (e o que a EN 301 549 V4.1.1 da UE exige). Checklist completa com os 55 critérios A/AA, ARIA, modais, regiões vivas e receita de testes → references/accesibilidade.md.
- HTML nativo antes que ARIA (
button,a href,label,fieldset,dialog); zerodivclicáveis. - Contraste: texto ≥ 4,5:1; texto grande (≥ 24 px, ou ≥ 18,66 px em negrito), bordas de input, ícones que informam e foco ≥ 3:1. Mede-se com a fórmula da WCAG 2.x, não com APCA.
- Teclado completo; foco visível (
:focus-visible) e não tapado por cabeçalhos ou barras fixas (scroll-padding); modais com o foco dentro, Esc e devolução do foco ao fechar. - Objetivos ≥ 24×24 px CSS como mínimo legal; projetar a 44–48 px em tátil.
- Tudo que se arrasta tem alternativa sem arrastar (kanban, ordenar, sliders).
- Erros em texto junto ao campo, com
aria-invalidearia-describedby; nada só por cor. - Estados assíncronos anunciados com
role="status"(oualertse forem urgentes), com a região montada de antemão. - Login: pode-se colar;
autocompletecomusername,current-passwordeone-time-code; sem testes cognitivos. - Não voltar a pedir o já introduzido no mesmo processo.
- Reflow a 320 px sem deslocamento horizontal (exceto tabelas de dados); zoom a 200 %;
prefers-reduced-motion. - Um axe a verde não significa acessível: no estudo do GOV.UK a melhor ferramenta encontrou ~41 % das barreiras (todas juntas, ~71 %), e a Deque calcula que o axe deteta ~57 % das incidências. É preciso também uma passagem com teclado e um teste rápido com leitor de ecrã.
5. Como trabalhar segundo a solicitação
Implementar ou melhorar UI em código
- Ler o sistema de design do projeto (tokens, primitivas, componentes parecidos já feitos) e reutilizar antes de criar.
- Escrever a necessidade, o contexto e os estados (§1).
- Construir primeiro a funcionalidade, com a hierarquia a cinzento; depois espaçamento, tipografia e cor com os tokens.
- Cobrir os estados: default, hover, focus-visible, active, disabled (com motivo), loading, vazio, erro, sucesso.
- Verificar: largura móvel (320–380 px) e desktop, teclado, contraste e textos longos ou dados extremos (nomes de 60 caracteres, montantes de 7 dígitos, listas de 0 e de 500 linhas). Se houver navegador disponível, olhar para o ecrã de verdade: uma captura mostra o que o código não mostra.
Rever uma tela, uma captura ou um PR
Passar §2–§4 e devolver:
- Resumo em 2–3 linhas: o que funciona e qual é o problema mais caro.
- Descobertas ordenadas por severidade (escala de Nielsen: 4 catastrófico, arranjar antes de publicar · 3 maior · 2 menor · 1 cosmético). Em cada uma: onde, que princípio viola (heurística, lei ou critério WCAG com número), a quem afeta e como, e a correção concreta (valor, componente, copy), separando o obrigatório do gosto. Declarar que a severidade é a de um único avaliador.
- Correções rápidas: no máximo 5, as de maior impacto e menor esforço.
- Perguntas abertas: o que só se resolve com dados ou com usuários.
Decidir entre alternativas
Comparar contra a tarefa principal e o contexto (§1), não por gosto. Se a diferença depende do comportamento real, dizê-lo e propor o teste mais barato que a resolveria (teste com 5 usuários, A/B, analítica): references/centrado-em-usuario.md §5.
Projetar sem código (fluxo ou wireframe)
Entregar a necessidade reformulada, o fluxo do caminho feliz com seus estados, a estrutura de cada tela justificada com um princípio por decisão e o que fica por validar com usuários.
6. Regras de comportamento
- Concreto antes que geral: "sobe o texto secundário de
gray-400paragray-600do Tailwind v3 (2,5:1 → 7,6:1 sobre branco; WCAG 1.4.3 pede 4,5:1)" em vez de "melhora o contraste". - Uma linha de porquê por recomendação, com a fonte. Se a fonte é do projeto, dizê-lo. Se é ofício, também.
- Presunção de ignorância de quem lê: nunca se assume que "toda a gente sabe" um padrão (Hick, Miller, desabilitados, contraste…). Explicar em 2–3 palavras quando se usa.
- Não dizer "intuitivo": a intuição é a memória de padrões aprendidos noutros sítios; se há convenção, nomeá-la.
- Propor, não impor: as decisões de design são do projeto; esta skill fornece a base para tomá-las, mas não as toma. Evitar "devemos" ou "há que"; usar "pode-se", "recomenda-se", "o normal é". Salvo WCAG, que se diz "obrigatório" e ponto.
- Quando não há tempo: priorizar a heurística de Nielsen 1 (estado visível), 4 (consistência) e 8 (minimalismo), mais a Lei de Fitts e o contraste mínimo. Com isto cobre-se 80 % das barreiras comuns.
- Não redesenhar só porque se pode: se uma interface funciona para a sua tarefa, com evidência suficiente, e não pediram revisão, não se revisa.
7. Modo de emergência
Se o projeto está lançado e com dados, aplicar §1 saltando a reformulação e ir direito ao que já se vê mal. A ordem é:
- Erros e bloqueios (heurística 9, 5).
- Contraste e foco (WCAG).
- Estado visível (heurística 1).
- Tudo o resto.