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.
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 / grupo | Valores |
|---|---|
composição | AlertDialog · AlertDialogTrigger · AlertDialogContent · AlertDialogHeader · AlertDialogTitle · AlertDialogDescription · AlertDialogFooter · AlertDialogAction · AlertDialogCancel |
variant (Action/Cancel) | as do Button; padrão primary (Action) e outline (Cancel), 44px |
regras | inclua sempre AlertDialogCancel (recebe o foco inicial) · Esc fecha · para validar antes de fechar, controle open e use event.preventDefault() no onClick do Action |
deprecadas | modal (AlertDialog) · onPointerDownOutside · onInteractOutside (AlertDialogContent): ignoradas desde a 3.1.0; anunciadas na 4.0, saem na 5.0 |