Quando usar modal

Use modais apenas para decisões ou tarefas curtas que exigem atenção imediata, sem substituir páginas e mensagens contextuais.

Wireframe de uma modal curta e central sobre uma página simplificada, com decisão breve e saída clara.
Nível de impácto
Alto
Status
Recomendado
Nível de evidênica
Forte evidência

Contexto

Uma modal cobre a página atual e impede a interação com o conteúdo ao fundo. Essa interrupção pode ajudar em decisões importantes, mas também pode fazer a pessoa perder contexto e dificultar a navegação.

Use uma modal quando a pessoa precisar tomar uma decisão breve, confirmar uma ação importante ou concluir uma tarefa curta sem sair da tela atual.

Escreva um título claro, explique o que está acontecendo e use botões com ações específicas, como “Excluir” e “Manter”. Antes de usar uma modal, verifique se uma página, mensagem contextual ou painel lateral resolveria o problema com menos interrupção.

Modal de alerta do Gov.br com título, texto curto e ações secundária e primária
Exemplo oficial do Gov.br: a modal de alerta interrompe a pessoa com uma informação, detalhe ou ação urgente. O exemplo mostra título, texto curto e ações com rótulos distintos. Fonte: Padrão Digital de Governo — Modal, Modal de Alerta: https://www.gov.br/ds/components/modal?tab=visao-geral

Porque isso importa?

Modais interrompem o fluxo e bloqueiam o conteúdo da página. O uso excessivo aumenta a carga cognitiva e pode dificultar a compreensão, especialmente em telas pequenas, com teclado e com tecnologias assistivas.

Quando usada, a modal precisa controlar corretamente o foco, impedir interações acidentais com o conteúdo ao fundo e permitir um fechamento previsível.

  • Confirmação de uma ação importante.
  • Decisão difícil de desfazer.
  • Mensagem crítica que exige reconhecimento.
  • Tarefa curta sem perda de contexto.
  • Informação complementar e pontual.
  • Escolha que bloqueia o próximo passo.
  • Formulários longos ou complexos.
  • Fluxos com várias etapas.
  • Mensagens comuns de erro ou sucesso.
  • Conteúdo principal da página.
  • Links externos que não exigem confirmação.
  • Interrupções automáticas e frequentes.
Modal de seleção do Gov.br com opções de rádio, botão de cancelamento e botão de confirmação
Exemplo oficial do Gov.br: a modal de opção por seleção apresenta alternativas e exige que a pessoa confirme uma delas antes de executar a ação. É adequada para escolhas delimitadas, não para substituir uma navegação ou um fluxo complexo. Fonte: Padrão Digital de Governo — Modal, Modal de Opção por Seleção: https://www.gov.br/ds/components/modal?tab=visao-geral

Recomendações

Faça

Práticas recomendadas
  • Use modais com moderação.
  • Abra após uma ação clara.
  • Escreva um título específico.
  • Use botões com ações explícitas.
  • Mantenha o conteúdo curto.
  • Ofereça uma saída clara.
Wireframe de modal curta com foco visível, título e descrição simulados, ações distintas e botão de fechar.
Modal curta com título claro, ações explícitas, foco visível e forma previsível de fechamento.

Evite

Práticas a evitar
  • Não abra sem contexto.
  • Não use “Sim” e “Não” isolados.
  • Não coloque páginas inteiras em modais.
  • Não esconda o botão de fechar.
  • Não use modal para toda mensagem.
  • Não bloqueie o usuário sem explicar.
Wireframe de modal grande com muitos campos, rolagem interna e fluxo complexo que deveria ocupar uma página.
Modal grande e complexa usada para um fluxo longo, com perda de contexto e múltiplas áreas de rolagem.
Modal de entrada do Gov.br com dois campos e ações secundária e primária
Exemplo oficial do Gov.br: a modal de entrada reúne campos e ações para concluir uma tarefa delimitada. O exemplo ajuda a reconhecer quando uma modal pode receber uma pequena entrada sem virar uma página ou um fluxo extenso. Fonte: Padrão Digital de Governo — Modal, Modal de Entrada: https://www.gov.br/ds/components/modal?tab=visao-geral

Acessibilidade

Use role="dialog" e nomeie a modal com um título visível por meio de aria-labelledby. Use aria-modal="true" somente quando o conteúdo ao fundo estiver realmente inativo para todas as pessoas.

Ao abrir, mova o foco para dentro da modal. Mantenha a navegação por Tab dentro dela, permita o fechamento com Escape quando apropriado e devolva o foco ao elemento que abriu a modal.

Inclua um botão de fechamento visível, preserve o indicador de foco, permita rolagem vertical em conteúdos maiores e teste com teclado, zoom e leitor de tela.

Checklist

  • A modal é realmente necessária?
  • A abertura ocorre após uma ação clara?
  • O título explica o propósito?
  • Os botões descrevem suas ações?
  • O conteúdo é curto e objetivo?
  • Existe uma forma clara de fechar?
  • O foco entra na modal?
  • O foco permanece dentro dela?
  • O foco retorna ao elemento acionador?
  • A solução foi testada com teclado e leitor de tela?

Referências

  • W3C — ARIA Authoring Practices Guide: Dialog (Modal) Pattern. Define o comportamento de uma modal, incluindo foco inicial, navegação por Tab, Escape, retorno do foco e uso de aria-modal. Consultar o padrão.
  • U.S. Web Design System — Modal. Recomenda usar modais com moderação, priorizar alternativas menos disruptivas e evitar fluxos complexos, mensagens comuns e conteúdos longos. Consultar o componente.
  • Padrão Digital de Governo — componente Modal. Orienta usar modais para interrupções propositais, decisões críticas e tarefas curtas sem perda de contexto; também recomenda conteúdo conciso e ações claras. Consultar o componente.
  • AMAWeb — Checklist ABNT NBR 17225. Relaciona a implementação de modais aos requisitos de foco visível, ordem previsível, ausência de bloqueio do teclado e acessibilidade por teclado. Consultar a checklist.
  • AMAWeb — Manual de acessibilidade digital. Reúne orientações sobre operação por teclado, foco, semântica e compatibilidade com tecnologias assistivas. Consultar o Manual.
Veja também

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