Botão primário e secundário: como definir a hierarquia

A hierarquia entre botões primários e secundários ajuda a indicar a ação principal sem transformar toda a tela em chamada para ação. Escolha a ênfase pela prioridade da tarefa, limite o destaque e mantenha as alternativas reconhecíveis.

Interface genérica com botão primário destacado e botão secundário em contorno
Nível de impácto
Médio
Status
Recomendado
Nível de evidênica
Evidência moderada

Contexto

Uma tela pode oferecer mais de uma ação: salvar e cancelar, continuar e voltar, publicar e salvar rascunho. A aparência dos botões precisa comunicar a prioridade relativa sem esconder alternativas nem decidir pela pessoa.

Defina qual ação representa o objetivo principal da pessoa naquele contexto e dê a ela a maior ênfase visual. Use o botão secundário para alternativas relacionadas, mas menos prioritárias, como cancelar, voltar ou salvar rascunho. A hierarquia deve ser avaliada por área da interface: uma página pode ter mais de uma área com ações principais, mas cada grupo precisa ter uma prioridade compreensível.

Use rótulos que descrevam a ação e mantenha as alternativas visíveis e reconhecíveis. Não use apenas cor para comunicar a diferença; combine ênfase, posição, espaçamento e texto. Siga a convenção do produto para ordenar os botões e teste o conjunto no contexto real, inclusive em telas menores.

Exemplos de botão com ênfase primária em fundos claro e escuro, nas versões com rótulo e circular
Exemplo real do Padrão Digital de Governo: a ênfase primária recebe maior destaque para a ação de maior prioridade, em fundos claro e escuro. Fonte: Gov.br Design System — Button, Ênfase Primária: https://www.gov.br/ds/components/button?tab=visao-geral

Porque isso importa?

Quando todos os botões têm o mesmo destaque, a pessoa precisa comparar opções antes de agir. Quando vários botões parecem primários, a interface perde um sinal importante de prioridade e pode aumentar a hesitação ou a escolha acidental.

Uma hierarquia clara reduz a disputa visual entre ações, facilita a varredura da tela e preserva o acesso às alternativas. Ela também beneficia pessoas que usam teclado, zoom ou tecnologias assistivas quando a diferença não depende apenas de cor e a ordem de foco acompanha a ordem lógica das ações.

  • Quando uma ação atende diretamente ao objetivo principal da tela ou etapa.
  • Quando um grupo reúne uma ação principal e alternativas relacionadas.
  • Quando “salvar”, “continuar” ou “concluir” precisa se destacar de “cancelar”, “voltar” ou “salvar rascunho”.
  • Quando a interface precisa orientar a atenção sem remover escolhas secundárias.
  • Quando o produto possui uma convenção consistente para níveis de ênfase.
  • Quando as ações tiverem a mesma prioridade e nenhuma merecer destaque.
  • Quando a diferença entre primário e secundário existir apenas pela cor.
  • Quando o botão secundário esconder uma ação importante ou difícil de encontrar.
  • Quando o destaque for usado para pressionar a pessoa a escolher uma opção que não é claramente melhor.
  • Quando a hierarquia não funcionar em telas pequenas, alto contraste ou navegação por teclado.
Exemplos de botão com ênfase secundária em fundos claro e escuro, nas versões com rótulo e circular
Exemplo real do Padrão Digital de Governo: a ênfase secundária acompanha ações menos prioritárias que a principal, em fundos claro e escuro. Ela mantém a alternativa disponível sem competir visualmente com a ação de maior prioridade. Fonte: Gov.br Design System — Button, Ênfase Secundária: https://www.gov.br/ds/components/button?tab=visao-geral

Recomendações

Faça

Práticas recomendadas
  • Defina a ação principal.
  • Limite o destaque primário.
  • Diferencie as alternativas.
  • Use rótulos claros.
  • Mantenha as opções visíveis.
  • Teste a hierarquia no contexto.
Formulário genérico com uma ação principal destacada e uma alternativa secundária visível
A ação principal se destaca, enquanto a alternativa continua visível, legível e disponível no mesmo grupo.

Evite

Práticas a evitar
  • Não destaque tudo.
  • Não dependa só de cor.
  • Não esconda a alternativa.
  • Não trate o secundário como irrelevante.
  • Não copie posições sem testar.
  • Não use rótulos ambíguos.
Interface genérica com vários botões coloridos de igual destaque
Todos os botões recebem o mesmo peso visual ou competem pelo destaque, dificultando identificar qual ação priorizar.
Dois cards do Adobe Spectrum; o primeiro apresenta Learn more e Open XD, e o segundo apresenta Start in-app tutorial
Exemplo real: a Adobe Spectrum mostra um card com “Open XD” como ação de maior destaque e “Learn more” como alternativa. O exemplo evidencia a hierarquia aplicada em contexto, não apenas em botões isolados. Fonte: Adobe Spectrum — Cards: https://spectrum.adobe.com/page/cards/

Acessibilidade

A diferença entre botões primários e secundários não deve depender apenas de cor. Use rótulos que expliquem a ação, contraste suficiente entre texto e fundo e estados de foco visíveis. A ordem de foco deve acompanhar a ordem lógica da tarefa, sem retirar a alternativa da navegação por teclado.

Use o elemento semântico <button> para ações e associe um nome acessível que corresponda ao rótulo visível. Em grupos relacionados, preserve uma estrutura compreensível para leitores de tela. Valide a hierarquia com teclado, zoom, diferentes configurações de contraste, leitores de tela e telas menores. A ênfase visual é uma recomendação de design; os requisitos de contraste, foco e uso de cor continuam sendo critérios de acessibilidade.

Checklist

  • Existe uma ação principal neste grupo?
  • Ela corresponde ao objetivo da tarefa?
  • O destaque primário está limitado?
  • As alternativas continuam visíveis e compreensíveis?
  • A diferença não depende apenas de cor?
  • Os rótulos descrevem as ações?
  • A ordem de foco é lógica?
  • A hierarquia funciona no mobile e no zoom?

Referências

  • Padrão Digital de Governo (Gov.br) — componente Button. Documenta níveis de ênfase para comunicar hierarquia e recomenda limitar a ênfase primária a ações estratégicas. Também registra uma convenção própria de posicionamento, que deve ser tratada como decisão do sistema e não como regra universal. Consultar o componente Button.
  • U.S. Web Design System — Button. Recomenda dar estilo distintivo à ação importante, evitar excesso de botões e usar rótulos curtos iniciados por verbos. Sustenta a necessidade de hierarquia e clareza, mas não determina uma única combinação visual para todos os produtos. Consultar o componente Button.
  • U.S. Web Design System — Button group. Orienta agrupar ações relacionadas, como uma ação principal e uma alternativa em formulários, e recomenda evitar excesso de opções no mesmo grupo. Consultar o componente Button group.
  • Atlassian Design System — Button. Recomenda usar o botão primário para a ação mais importante da área e limitar sua ocorrência; os demais botões devem receber menor ênfase conforme sua função. Consultar as orientações de botões.
  • W3C — WCAG 2.2, Critério 1.4.1: Uso de cor. Sustenta que a diferença de prioridade não deve ser comunicada somente por cor; o conteúdo e os controles precisam de outra forma de identificação. Consultar o critério 1.4.1.
  • Adobe Spectrum — Button. Diferencia os níveis accent, primary e secondary e usa a ênfase para estabelecer hierarquia; orienta que o botão secundário acompanhe outros tipos e não seja o único botão do grupo. Consultar o componente Button.
  • Adobe Spectrum — Cards. Mostra uma composição em que “Open XD” recebe maior destaque e “Learn more” funciona como alternativa, ilustrando a hierarquia aplicada dentro de um contexto. Consultar o componente Cards.
Veja também

Esta recomendação foi útil para você?