Diálogo de alerta

Confirmação perigosa. Força decisão (ação/cancelar) antes de prosseguir: role="alertdialog", sempre modal, não fecha por clique fora e abre com o foco no Cancelar. No código: alert-dialog — src/components/alert-dialog.tsx · Feedback e estados

Quando usar

Sempre que uma ação for irreversível ou tiver impacto significativo — exclusão de registro, cancelamento de processo, envio definitivo. O diálogo impede que a ação aconteça por acidente.

Quando não usar

Para ações reversíveis ou de baixo impacto (confirmar uma edição simples), use feedback inline ou um Dialog comum. Para erros que já aconteceram, use Alert.

Acessibilidade

  • O Radix AlertDialog define role="alertdialog" automaticamente.
  • O foco é capturado dentro do diálogo e não pode sair até fechar (focus trap).
  • Esc fecha o diálogo e retorna o foco ao elemento que o abriu.
  • O overlay clicável também fecha o diálogo.
  • AlertDialogTitle e AlertDialogDescription vinculados via aria-labelledby e aria-describedby.

AlertDialogAction confirma; AlertDialogCancel fecha sem executar. Ambos acionam o fechamento do Radix.

Preview

Variantes e composição

Prop / grupoValores
composiçãoAlertDialog · AlertDialogTrigger · AlertDialogContent · AlertDialogHeader · AlertDialogTitle · AlertDialogDescription · AlertDialogFooter · AlertDialogAction · AlertDialogCancel
variant (Action/Cancel)as do Button; padrão primary (Action) e outline (Cancel), 44px
regrasinclua sempre AlertDialogCancel (recebe o foco inicial) · Esc fecha · para validar antes de fechar, controle open e use event.preventDefault() no onClick do Action
deprecadasmodal (AlertDialog) · onPointerDownOutside · onInteractOutside (AlertDialogContent): ignoradas desde a 3.1.0; anunciadas na 4.0, saem na 5.0

Uso

Fonte do componente