Componentes reutilizáveis no React: como evitar o "Button2Final"
Button, Button2, ButtonNovo, ButtonFinal. Como criar componentes React reutilizáveis de verdade — e evitar a proliferação de variações.
Por Roger C. Ribeiro, fundador da Wecodex3 min de leitura
Button, Button2, ButtonNovo, ButtonFinal. Como criar componentes React reutilizáveis de verdade — e evitar a proliferação de variações.
Todo projeto React começa com intenção de reaproveitar componentes. Meses depois, há cinco versões de botão, três de modal e dezenas de cards quase iguais. Cada correção precisa ser feita em vários lugares, e a interface fica inconsistente.
Por que acontece
Alguém precisa de um botão "um pouco diferente", não entende o componente existente ou tem medo de quebrar outras telas. Copiar parece mais seguro.
Princípios de um componente reutilizável
- 1.Variantes em vez de cópias:
<Button variant="primary" | "ghost" | "danger">. - 2.Todos os estados incluídos: hover, foco, ativo, desabilitado, carregando (Tailwind sem bagunça: estados hover, focus, active e disabled do jeito certo).
- 3.API pequena e clara: poucas propriedades, bem nomeadas.
- 4.Composição:
<Card><Card.Header />...</Card>em vez de dezenas de propriedades. - 5.Acessível por padrão: papéis, rótulos e foco corretos (Navegação por teclado e focus-visible: o detalhe que separa sites amadores).
- 6.Tipado com TypeScript.
Onde ficam
Uma pasta de componentes base usada por todo o produto, documentada com exemplos. Esse é o coração de um design system (Design System na prática: padronize a UX/UI do seu produto).
Quando criar um novo componente
Quando o comportamento é diferente, não só a aparência. Mudança visual pequena é variante.
Refatorando o que já existe
Escolha um componente (o botão, geralmente), crie a versão definitiva com todas as variantes necessárias e substitua as cópias aos poucos. Repita.
A Wecodex constrói interfaces com componentes padronizados. Veja sites e sistemas ou fale com a gente.
- React
- Componentes
- Arquitetura
- Design System
Escrito por
Roger C. RibeiroFundador da Wecodex. Escreve sobre engenharia de software, performance, APIs, segurança e IA aplicada a empresas.
Serviços relacionados
Resolver de vez, com quem faz isso todo dia
Seu site precisa carregar em menos de um segundo e converter mais?
Este artigo mostra o caminho. A implementação sob medida, o detalhe que muda o resultado no seu caso, é o trabalho da Wecodex, empresa de engenharia do grupo Wocom.
Continue lendo
Tudo sobre Web & Performance- Ler artigo
Web & Performance3 min
Design System na prática: padronize a UX/UI do seu produto
Botões diferentes em cada tela, espaçamentos no chute e cada dev inventando um cinza? Veja como um design system resolve e o que separa "organizado" de "nível Apple".
- Ler artigo
Web & Performance3 min
Tailwind sem bagunça: estados hover, focus, active e disabled do jeito certo
Botão sem foco visível, link sem hover, campo desabilitado que parece ativo. Veja como organizar estados interativos com Tailwind de forma consistente.
- Ler artigo
Web & Performance3 min
Navegação por teclado e focus-visible: o detalhe que separa sites amadores
Aperte Tab no seu site. Se você não consegue ver onde está, muitos usuários também não. O foco visível é um detalhe que separa produtos sérios dos amadores.